🧠 An AI-powered mental health screening app built with Flutter + Supabase, designed for culturally-aware, multilingual support.
Suno – Samjho is your personal mental health companion app that blends AI, speech & text analysis, and clinical models to help detect early signs of depression and anxiety.
It has been carefully designed with:
- 🌍 Cultural sensitivity (supports 22+ Indian languages & Hinglish)
- 🔒 Privacy-first architecture (encrypted sessions & data protection)
- 📱 Accessibility-first approach (smooth performance on 92% of Android & iOS devices)
Our goal is simple: make mental health support affordable, accessible, and stigma-free.
- 🌐 Multilingual Support → 22+ Indian languages (Hinglish & code-switching included)
- 🎙 Voice & Text Screening → Detect emotional state in real-time
- 🤖 AI Chatbot → Built on CBT, ACT & mindfulness frameworks
- 🔑 Authentication → Secure sign-in with Supabase (Google & Email)
- 🚨 Crisis Response → Real-time risk detection & escalation to professionals
- 📊 Dashboard → Track emotional health stats, mood patterns, and AI suggestions
- 🔒 Privacy-First → Encrypted storage, no compromise on anonymity
Frontend: Flutter (Dart)
Backend: Supabase (Auth, DB, Storage) + FastAPI (AI endpoints)
AI / NLP Models: HuggingFace Transformers, IndicBERT, Whisper
Database: Supabase Postgres
Other Tools: Firebase (notifications), Docker, GitHub Actions
Before you begin, ensure you have the following installed:
| Tool | Version | Installation |
|---|---|---|
| Flutter SDK | 3.8.0+ | flutter.dev/docs/get-started/install |
| Dart SDK | 3.8.1+ | Included with Flutter |
| Git | Latest | git-scm.com |
| Android Studio (for Android) | Latest | developer.android.com |
| Xcode (for iOS, macOS only) | 14+ | App Store |
| Chrome (for Web) | Latest | google.com/chrome |
Verify your Flutter installation:
flutter doctorgit clone https://github.com/your-username/suno-samjho.git
cd suno-samjhoflutter pub getThis app uses Supabase for authentication and database. You'll need to set up your own Supabase project or use the shared development credentials.
Request access to the shared development Supabase project by:
- Opening an issue with the label
access-request - A maintainer will add you to the dev project and share credentials
- Go to supabase.com and create a free account
- Create a new project
- Navigate to Settings → API to find your credentials
- Enable Email/Password and Google OAuth in Authentication → Providers
Create a .env file in the project root (this file is gitignored):
SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_ANON_KEY=your-anon-key-here
⚠️ Never commit your.envfile! It contains sensitive credentials.
flutter run -d chromeflutter run -d androidflutter run -d iosflutter devices # List available devices
flutter run -d <device_id>flutter test- UI Wireframes (Onboarding, Dashboard, Chatbot)
- Supabase Authentication (Google + Email)
- Voice-to-Text Pipeline (Whisper API)
- Multilingual NLP Analysis (IndicBERT + HuggingFace)
- Real-time Risk Scoring & Crisis Protocols
- Clinical Trial & Feedback Phase
- 🌍 Aiming to reach 100M+ underserved Indians lacking mental health access
- 📉 Potential 30–50% reduction in depression symptoms after consistent 6-week usage
- 🔐 Built on ethics-first design principles, prioritizing user privacy, safety, and accessibility
We welcome contributors from AI, Flutter, healthcare & design backgrounds!
New to the project? Look for issues labeled with:
| Label | Description |
|---|---|
good first issue |
Beginner-friendly tasks, great for first-time contributors |
help wanted |
Issues where we need community help |
documentation |
Improve docs, READMEs, or code comments |
ui/ux |
Design improvements & accessibility fixes |
bug |
Confirmed bugs that need fixing |
- Browse existing issues or create a new one
- Comment on the issue to let maintainers know you're working on it
- Wait for assignment before starting (to avoid duplicate work)
# Fork via GitHub UI, then:
git clone https://github.com/YOUR-USERNAME/suno-samjho.git
cd suno-samjho
git remote add upstream https://github.com/ORIGINAL-OWNER/suno-samjho.gitgit checkout -b feature/your-feature-name
# or for bugs:
git checkout -b fix/issue-description- Follow the existing code style
- Write meaningful commit messages
- Add tests for new features when possible
flutter analyze # Check for lint issues
flutter test # Run tests
flutter run -d chrome # Manual testinggit push origin feature/your-feature-nameThen open a PR on GitHub with:
- Clear description of what you changed and why
- Reference to the related issue (e.g.,
Fixes #123) - Screenshots for UI changes
lib/
├── main.dart # App entry point
├── auth/ # Authentication screens & logic
├── chatbot/ # AI chatbot interface
├── config/ # App configuration & constants
├── home/ # Home/Dashboard screens
├── onboarding/ # Onboarding flow
├── profile/ # User profile management
├── services/ # API & Supabase services
├── splash/ # Splash screen
└── info/ # Info/About screens
- Follow Effective Dart conventions
- Use meaningful variable and function names
- Keep widgets small and focused (prefer composition)
- Add comments for complex logic
- Run
flutter analyzebefore committing
This project is licensed under the MIT License.
You are free to use, modify, and distribute this software with attribution.
If you find this project meaningful, please ⭐ the repo and help spread awareness for mental health tech 💙.