Skip to content

README.md

Latest commit

 

History

History
162 lines (126 loc) · 4.79 KB

README.md

File metadata and controls

162 lines (126 loc) · 4.79 KB

🌈 Mood Tracker App

A beautifully simple mood-tracking app built with Streamlit. Track emotions, explore trends, and receive AI-powered insights.

Built with tech-stack like:

📝 Mood Tracker App (Streamlit)

A sophisticated Mood Tracker App built with Streamlit, SQLite, and Matplotlib, designed to help users seamlessly log their daily moods, track emotional patterns, and visualize trends over time. The app features interactive data visualization, historical mood analysis, and AI-driven mood predictions for deeper emotional insights. With a user-friendly interface, it empowers individuals to understand their mental well-being better and make informed lifestyle adjustments. 🚀

✨ Features

  • ✅ Log Daily Mood
  • 📊 Trend Visualization
  • 🧠 AI Insights (Optional)
  • 🗂 History Log
  • 💻 Modern UI
  • 🔒 Privacy Focused

📁 Project Structure

📦 mood-tracker-app-streamlit/
├── main.py
├── requirements.txt
├── modules/
│   ├── db.py
│   ├── visualization.py
│   └── guidances.py
├── databases/
│   └── mental_health.db
├── assets/
└── .github/workflows/
    └── deploy.yml

📸 Screenshots

Dashboard Mood Entry Mood Trends

🌐 Web UI Preview

Mood.tracker.App.Dashboard.-.Made.with.Clipchamp.mp4

🛠 Tech Stack

  • Frontend: Streamlit
  • Backend: Python, SQLite
  • Data Analysis: Pandas, Matplotlib, NLTK
  • Authentication: Streamlit session state

🚀 Getting Started

1️⃣ Clone the Repository

git clone https://github.com/Anamicca23/mood-tracker-app-streamlit.git
cd mood-tracker-app-streamlit

2️⃣ Create Virtual Environment

python -m venv venv

3️⃣ Activate It

  • Windows: venv\Scripts\activate
  • Mac/Linux: source venv/bin/activate

4️⃣ Install Dependencies

pip install -r requirements.txt

5️⃣ Run the App

streamlit run main.py

📌 Note: Python 3.9+ recommended

📤 Export Data

Click "Download CSV" in-app

☁️ Deployment

  • Docker support
  • GitHub Actions
  • Platforms: Google Cloud Run, Streamlit Community, Heroku

🧠 Powered by AI

Leverage GPT to analyze moods.

Setup AI:

  • Get API key from OpenAI
  • Add to .env or in guidances.py
export OPENAI_API_KEY="your-key-here"

📅 Upcoming Features

Feature Status
Multi-user support 🛠 In Progress
Mobile UI ✅ Done
Mood Export Planned
Email Reminders Planned
API Integration Researching

📚 Use Cases

  • Self-reflection
  • Mental Health Research
  • Therapy Tool
  • Mindfulness Journal

🤝 Contributing

git checkout -b feature/yourFeature
git commit -m "Add your awesome feature"
git push origin feature/yourFeature

👩‍💻 Author

Anamika Kumari
📬 GitHub

🌟 Support & Feedback

Star ⭐ the repo & share feedback!

💚 Made with mindfulness to help you track, reflect, and thrive 💚

Back to Top