MoodScribe
CSE 3200:システム開発プロジェクト
- スター
- 1
- フォーク
- 1
- 最終プッシュ(UTC)
- 2026/04/03
- プロジェクト状態
- 公開中
元の README
以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。
MoodScribe: An AI-Powered Journaling Companion 🧠✨
An intelligent mental wellness companion that analyzes stress from journal entries and provides personalized recommendations to improve your well-being.
- Overview
- Key Features
- Screenshots
- Tech Stack & Architecture
- Deployment
- Related Repositories
- Getting Started
- License
- Acknowledgements
Overview
MoodScribe is a mobile application built with Flutter that serves as an intelligent mental wellness companion. It leverages AI and Natural Language Processing (NLP) to monitor emotional health through journaling. The app detects user stress levels from diary entries, provides psychological insights, and offers personalized lifestyle recommendations—books, music, movies, and exercises—to improve mental well-being.
Key Features
-
🤖 AI-Powered Journaling & Stress Analysis: Classifies entries into "Stress" or "No Stress" and identifies the specific aspect of stress (e.g., Relationships, Financial).
-
💡 Personalized AI Recommendations: A LangChain-powered AI agent suggests movies, books, music, and habits based on your emotional history and mood trends.
-
✅ Wellness-Centric To-Do List: Build good habits with a smart to-do list that reinforces daily actions for mental well-being, with smart reminders and AI categor
-
ization.
-
📊 User Profile & Mood Insights: A personal dashboard with stats like your current streak, mood visualizations via pie charts, and a hub for your bookmarked favorites.
-
🗓️ Activity Tracking Heatmap: A calendar heatmap visually tracks your journaling consistency, motivating you to build a strong daily habit.
-
📝 Personalized AI Suggestions: A LangChain-powered AI agent provides personalized suggestions based on your emotional history and mood trends.
System Architecture
Tech Stacks
-
Frontend: Flutter (Dart)
-
Backend APIs: Python (FastAPI)
-
AI Agent Framework: LangChain
-
ML Model: Custom Ensemble Model (GAN + BiLSTM)
-
Database: Firebase Firestore
-
Deployment: Render (Backend), GitHub Actions CI/CD (Frontend)
Screenshots
Deployment
-
Backend Services: The AI Agent and the Stress Model are each deployed as separate FastAPI web services on Render, providing scalable and secure API endpoints.
-
Frontend Application: The Flutter app is built and released automatically using a CI/CD pipeline configured with GitHub Actions. Every push to the main branch triggers a workflow that builds, signs, and attaches a release-ready APK to a new GitHub Release.
Related Repository
1. MoodScribe AI Agent
-
Description: This repository contains the LangChain-powered AI agent responsible for generating personalized recommendations. It's built with Python and deployed as a FastAPI service on Render.
2. MoodScribe Stress Model
-
Description: This repository contains the custom-trained ensemble machine learning model (Guided Attention Newtork + BiLSTM) used for stress detection and classification. It is also deployed as a FastAPI service on Render.
Getting Started
To get a local copy up and running, follow these simple steps.
Prerequisites
-
Flutter SDK installed
-
An editor like VS Code or Android Studio
Installation
1.Clone the repo
git clone <Repository_Link>
2.Install Flutter packages
flutter pub get
1.Run the app
flutter run
Acknowledgements
カテゴリー
使用している依存関係
依存関係一覧 21 件
- flutter
{"sdk":"flutter"} - cupertino_icons
^1.0.8 - google_fonts
^6.2.1 - flutter_staggered_grid_view
^0.7.0 - fl_chart
^0.69.2 - intl
^0.20.1 - animations
^2.0.11 - http
^1.2.2 - firebase_core
^3.9.0 - cloud_firestore
^5.6.0 - flutter_svg
^2.0.9 - flutter_heatmap_calendar
^1.0.5 - google_generative_ai
^0.2.0 - firebase_auth
^5.4.1 - lottie
^3.2.0 - provider
^6.1.2 - shared_preferences
^2.2.2 - flutter_launcher_icons
^0.14.3 - awesome_notifications
^0.10.1 - google_sign_in
^6.2.2 - flutter_test開発用
{"sdk":"flutter"}
プロジェクトに合うリポジトリを選ぶには?
用途で絞り込み、開発状況を比較し、採用前に元のリポジトリで要件を確認しましょう。
- 名前・作者・説明で検索し、技術トピックで絞り込みます。
- スター、フォーク、最近のプッシュを比較します。スターは関心の目安であり、品質の保証ではありません。
- 利用前に GitHub で README、ライセンス、Issues を確認します。
情報源と管理
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗