🧞‍♂️ MoodGenie - Your Emotional AI Companion

MoodGenie is an AI-powered mood journaling and companion app built using Flutter (frontend) and FastAPI + Gemini API (backend). It helps users reflect on their thoughts, get emotionally intelligent replies, and store their mood summaries locally using Hive.

📥 Download MoodGenie App: Download APK

🚀 Features

🧠 AI-generated emotional responses using Google Gemini API
✨ Auto-generated mood summaries stored locally on device
🐝 Local database using Hive (no internet needed for mood history)
📱 Shareable as APK, without the Play Store
🌐 Backend deployed via FastAPI on Render
🎨 Beautiful UI with custom animations and Google Fonts

📦 Tech Stack

Layer	Technology
Frontend	Flutter
Backend	FastAPI
AI Model	Google Gemini (gemini-2.0-flash-lite)
Local Storage	Hive

🛠️ Prerequisites

Before you begin, ensure you have the following installed:

For Backend:

Python 3.8+ - Download Python
pip (Python package manager, comes with Python)

For Frontend:

Flutter SDK 3.8.0+ - Install Flutter
Dart SDK (comes with Flutter)
Android Studio (for Android development) or Xcode (for iOS development on macOS)
A code editor like VS Code or Android Studio

API Keys:

Google Gemini API Key - Get API Key

⚙️ Backend Setup

1. Navigate to Backend Directory

cd backend

2. Create Virtual Environment (Recommended)

# On macOS/Linux
python3 -m venv venv
source venv/bin/activate

# On Windows
python -m venv venv
venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

Create a .env file in the backend directory:

touch .env

Add your Gemini API key to the .env file:

GEMINI_API_KEY=your_gemini_api_key_here

Replace your_gemini_api_key_here with your actual API key from Google AI Studio.

5. Run the Backend Server

# Development mode with auto-reload
uvicorn main:app --reload

# Production mode
uvicorn main:app --host 0.0.0.0 --port 8000

The backend API will be available at http://localhost:8000

API Endpoints:

POST /chat - Send user prompt and receive AI response
GET /summary - Get conversation summary when app closes

📱 Frontend Setup

1. Navigate to Frontend Directory

cd frontend

2. Install Flutter Dependencies

flutter pub get

3. Configure Backend URL

Open lib/screens/home_screen.dart and update the API URL if needed:

final url = Uri.parse('http://localhost:8000/chat'); // For local testing
// OR
final url = Uri.parse('https://moodgenie.onrender.com/chat'); // For production

4. Verify Assets

Ensure the following assets are present in the assets/ directory:

app_icon.png - App launcher icon
cloudy_animation.mp4 - Background animation (optional)

5. Run the App

For Android:

flutter run

For iOS (macOS only):

cd ios
pod install
cd ..
flutter run

For Web:

flutter run -d chrome

6. Build APK (Android)

To create a release APK:

flutter build apk --release

The APK will be located at: build/app/outputs/flutter-apk/app-release.apk

For split APKs per ABI (smaller file sizes):

flutter build apk --split-per-abi

🎯 Project Structure

MoodGenie/
├── backend/
│   ├── main.py                          # FastAPI server
│   ├── gemini_handler.py                # Gemini AI integration
│   ├── moodgenie_training_data.json     # AI training context
│   ├── requirements.txt                 # Python dependencies
│   ├── .env                             # Environment variables (not tracked)
│   └── .gitignore
├── frontend/
│   ├── lib/
│   │   ├── main.dart                    # App entry point
│   │   └── screens/
│   │       ├── splash_screen.dart       # Welcome screen
│   │       ├── mainAppScreen.dart       # Main navigation
│   │       ├── home_screen.dart         # Chat interface
│   │       └── history_screen.dart      # Mood history
│   ├── assets/
│   │   ├── app_icon.png                 # App icon
│   │   └── cloudy_animation.mp4         # Background video
│   ├── pubspec.yaml                     # Flutter dependencies
│   └── .gitignore
└── README.md

🧪 Testing the Application

Backend Testing:

Start the backend server:
```
cd backend
uvicorn main:app --reload
```

Test the chat endpoint:

curl -X POST http://localhost:8000/chat \
  -H "Content-Type: application/json" \
  -d '{"user_prompt": "I am feeling happy today!"}'

Test the summary endpoint:
```
curl http://localhost:8000/summary
```

Frontend Testing:

Ensure backend is running
Launch the Flutter app
Test conversation flow
Check mood history storage
Verify summary generation on app close

🌐 Deployment

Backend Deployment (Render):

Push your code to GitHub
Connect your repository to Render
Set environment variable: GEMINI_API_KEY
Deploy with build command: pip install -r requirements.txt
Start command: uvicorn main:app --host 0.0.0.0 --port $PORT

Frontend Deployment:

Android: Share the APK file directly
iOS: Distribute via TestFlight or App Store
Web: Deploy using flutter build web and host on Firebase/Netlify/Vercel

🔧 Troubleshooting

Common Backend Issues:

Issue: ModuleNotFoundError: No module named 'fastapi'
Solution: Run pip install -r requirements.txt in the backend directory

Issue: google.generativeai.types.generation_types.BlockedPromptException
Solution: Check your API key and ensure it's valid

Common Frontend Issues:

Issue: Failed to load asset
Solution: Run flutter pub get and verify assets in pubspec.yaml

Issue: Connection refused when testing
Solution: Ensure backend server is running and URL is correct in home_screen.dart

Issue: Build fails for iOS
Solution: Run cd ios && pod install && cd .. then try again

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is open source and available for educational purposes.

👤 Author

Aryan Varshney

GitHub: @AryanV-Coder

🙏 Acknowledgments

Google Gemini AI for the conversational intelligence
Flutter team for the amazing framework
FastAPI for the lightning-fast backend framework
Hive for efficient local storage

📞 Support

If you encounter any issues or have questions, please:

Check the Troubleshooting section
Review existing issues on GitHub
Create a new issue with detailed information

Happy Coding! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
backend		backend
frontend		frontend
.gitignore		.gitignore
README.md		README.md

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

🧞‍♂️ MoodGenie - Your Emotional AI Companion

🚀 Features

📦 Tech Stack

🛠️ Prerequisites

For Backend:

For Frontend:

API Keys:

⚙️ Backend Setup

1. Navigate to Backend Directory

2. Create Virtual Environment (Recommended)

3. Install Dependencies

4. Configure Environment Variables

5. Run the Backend Server

API Endpoints:

📱 Frontend Setup

1. Navigate to Frontend Directory

2. Install Flutter Dependencies

3. Configure Backend URL

4. Verify Assets

5. Run the App

For Android:

For iOS (macOS only):

For Web:

6. Build APK (Android)

🎯 Project Structure

🧪 Testing the Application

Backend Testing:

Frontend Testing:

🌐 Deployment

Backend Deployment (Render):

Frontend Deployment:

🔧 Troubleshooting

Common Backend Issues:

Common Frontend Issues:

🤝 Contributing

📄 License

👤 Author

🙏 Acknowledgments

📞 Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages