패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소Efty34/MoodScribe

MoodScribe

CSE 3200: 시스템 개발 프로젝트

MoodScribe 프로젝트 이미지
스타
1
포크
1
최근 푸시(UTC)
2026. 4. 3.
프로젝트 상태
활성

원본 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.

  1. Overview
  2. Key Features
  3. Screenshots
  4. Tech Stack & Architecture
  5. Deployment
  6. Related Repositories
  7. Getting Started
  8. License
  9. 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.

  • MoodScribe Ai Agent

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.

  • MoodScribe Stress Model

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

Efty Hasan GitHub avatar
GitHub 작성자

Efty Hasan ↗

Master of none.

Bangladesh
언어DartC++CMakeSwiftCHTMLKotlinObjective-C

분류

사용 중인 의존성

의존성 목록 21 개

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗