Skip to content
BranchesTags

Repository files navigation

Rhythma logo

Rhythma 🌸

Her Rhythm. Her Health. Her Power.

A multilingual, offline-first, AI-powered menstrual & women's health companion — built from the ground up for Indian women.

Flutter FastAPI Gemini API License: MIT Status

Table of Contents

🎯 The Problem

1 in 5 Indian women experience PCOD/PCOS symptoms, and national studies show a 19.6% PCOS prevalence using Rotterdam criteria — yet most cases go unnoticed for years. Women in Tier-2, Tier-3, and semi-urban India face a compounding set of barriers:

  • Popular period-tracking apps (Flo, Clue) assume 28-day cycles, English fluency, and stable internet
  • Gynecologist access remains limited outside major cities
  • Deep social stigma discourages open conversations about reproductive health
  • Only 26% of Indian women have regular mobile internet access
  • No AI tool built natively for Indian languages, realities, and connectivity constraints

"Women's healthcare is not inaccessible because solutions don't exist. It is inaccessible because current solutions are not designed around Indian realities."

Rhythma is built from the ground up for Indian women — not adapted from a solution built for another market.

✨ What Rhythma Does

Rhythma helps women understand, track, and act on their health privately, in their own language. Users log cycles, symptoms, mood, sleep, and lifestyle habits; Rhythma turns that data into personalized, on-device health insights instead of just raw charts.

Rhythma aims to be an offline-first, multilingual women's health companion for tier-2 and tier-3 Indian cities — supporting cycle tracking, an AI health assistant, and personalized wellness scoring in regional languages.

Platforms

Rhythma consists of two front ends sharing one backend, not two separate products:

  1. Flutter mobile app (rhythma_flutter/) — the primary experience today. Most of the UI described in this README lives here.
  2. Website (web/) — a browser-based client aiming for the same features as the app (cycle tracking, AI Assistant, Insights, Profile), talking to the same FastAPI backend, for women who don't have or don't want to install a mobile app. This is separate from landing-page/, a Next.js marketing site that explains the product but runs none of its functionality. Don't confuse the two when navigating the codebase.

Who Rhythma Is For

Rhythma is designed to grow into support for multiple groups of Indian women, each with different needs. Not all of these are served by the app yet — this is the target scope, not a claim about current functionality.

Group Age / context What they need
Teen girls (first period journey) 12–17 Simple, non-clinical first-period guidance and menstrual education
College students & working women 18–35 Irregular-cycle tracking, PCOD/PCOS awareness, hormonal health support — primary users of the current app
Women with irregular cycles 18–35+ Long-term cycle consistency trends, not single-cycle guesswork
Community / self-help groups Extended ecosystem (NGOs, rural users, shared devices) across Tier-2, Tier-3 & semi-urban India Offline access, SMS support, and eventually WhatsApp-based access without needing to install an app
Feature Details
Languages Hindi, Marathi, Tamil, Telugu, English — more planned
Cycle Metrics Factual cycle statistics (averages, shortest/longest cycles) and consistency trends
Connectivity Offline-first; core features work with zero internet, sync when available
Privacy 100% on-device processing and storage by default

Contributors working on onboarding flows, content, or accessibility should keep these different personas in mind, especially the gap between the adult-focused experience and the teen-focused one.

Screenshots

(Screenshots below reflect UI mockups)

Dashboard Cycle Calendar AI Assistant
Dashboard Calendar AI Assistant
Health Insights SMS Summary
Health Insights SMS

Demo Video

Two UI walkthroughs (mockups) are included in the repo under design-concepts/:

Live Demo

The public landing page is live at rhythma-navy.vercel.app. (This is the marketing site, not the app itself.)

🆚 How Rhythma Compares

Feature Flo SheBloom HerMantra Rhythma
PCOS/PCOD Support ✅ ✅ ✅ ✅
AI Early Risk Detection ✅ ➖ ➖ ✅
Offline Functionality ❌ ✅ ➖ ✅
SMS-Based Health Support ❌ ❌ ❌ ✅
Privacy-First Data Ownership ✅ ✅ ➖ ✅
Indian Language Support ❌ ✅ ✅ ✅
Cycle Consistency Analysis (Factual) ❌ ❌ ❌ ✅
Personalized Trend Insights (Factual) ❌ ❌ ❌ ✅
Educational Ayurvedic Layer ❌ ➖ ✅ ✅

Feature comparison based on publicly available information from official websites, app stores, and product documentation. Availability may change over time.

Key insight: Existing platforms solve specific problems. Rhythma combines multiple underserved needs into one India-first ecosystem.

🚀 Key Features

Feature Status Description
🌸 Smart Cycle Tracking ✅ Handles irregular cycles, no fixed 28-day assumption. Flow, mood, and symptom logging.
🤖 Gemini-Powered AI Assistant ✅ Real google-generativeai integration (gemini-2.5-flash), gated behind rate limits.
📊 Cycle Variability Index (CVI) ✅ Trained XGBoost model shipped in-repo, with a documented heuristic fallback.
❤️ Menstrual Health Score (MHS) 🟡 Live today as a hand-written weighted average (CVI + sleep + stress + symptoms + lifestyle). The planned Logistic Regression ensemble is not built yet, and the lifestyle component silently falls back to a default score until profile fields land (#112).
🏥 Hormonal Risk Indicator ✅ 3-tier (Low/Medium/High) alerting derived from CVI.
📱 Offline-First Architecture 🟡 Hive local storage + Firestore sync and a sync-status indicator are implemented; automatic queue-and-retry on reconnect is not yet built (#229).
🔒 Privacy-First Design ✅ Auth, password policy, rate limiting, and a dedicated data-privacy/export service are implemented server-side.
🌍 Indian Regional Languages 🟡 17 languages have translation files, far beyond the 3 originally announced — but 4 of the .arb files (hi, mr, ta, te) currently contain invalid JSON (duplicate/malformed entries) that will break flutter gen-l10n codegen until fixed. The base app_en.arb file is valid.
📩 SMS Health Summaries ✅ Real Twilio Client integration, gated on optional env credentials.
🌿 Ayurvedic Correlation Layer ✅ Educational wellness content layer merged (PR #436).
💬 WhatsApp / Telegram Bot ✅ Full chat-linking + command engine (status, link, unlink, help) implemented — well ahead of the old roadmap's "Phase 4" label.
🩺 Provider Portal ✅ Provider registration/login, patient consent, access logs, and patient list endpoints are implemented server-side — most of the old "Phase 5" scope.
📄 PDF Health Report Export ✅ Implemented client-side in Flutter via pdf/printing.
🌐 Web Application 🟡 Real Vite + React + TypeScript app exists with its own auth flow and test suite — it is not "planned," but it's missing feature-parity pages (#247) and has no CI workflow yet (#248).

ML models run entirely on-device. No sensitive health data leaves the phone unless the user explicitly enables cloud sync.

🛠️ Detailed Technology Stack

Mobile — rhythma_flutter/

Package Version Purpose Status in code
flutter (SDK) — Core framework —
dio ^5.4.3 HTTP client Used in api_client.dart, auth_service.dart
http ^1.2.2 Secondary HTTP client Present
flutter_secure_storage ^9.2.2 Secure token storage Used in secure_storage.dart
provider ^6.1.2 State management Used across providers/
google_fonts ^6.2.1 Typography Used in theme
go_router ^13.2.0 Navigation Used
hive / hive_flutter ^2.2.3 / ^1.1.0 Local offline storage Used extensively in local_storage_service.dart
firebase_core / cloud_firestore / firebase_auth ^3.3.0 / ^5.2.1 / ^5.1.3 Cloud sync Initialized in main.dart (Firebase.initializeApp()) and wired to FirestoreService for client-side offline-first sync — see Flutter Client Firebase Setup
encrypt ^5.0.3 Local encryption Present
fl_chart ^0.68.0 Charts Used in components/charts.dart
flutter_localizations / intl — / ^0.20.2 i18n Used, 5 languages generated
permission_handler ^12.0.3 Runtime permissions Used by notification service
connectivity_plus ^6.0.3 Network state Used in firestore_service.dart to detect connectivity and auto-trigger sync on restore
shared_preferences ^2.3.2 Lightweight key-value storage Present
url_launcher ^6.3.0 Open external links Present
flutter_local_notifications / timezone ^22.0.1 / ^0.11.1 Local notifications Used, but only wired to manual Settings toggles
email_validator ^3.0.0 Form validation Present
flutter_lints ^4.0.0 (dev) Linting Used in CI

Backend — backend/ (requirements.txt)

Package Version Purpose
fastapi 0.111.0 Web framework
uvicorn[standard] 0.30.1 ASGI server
pydantic / pydantic-settings 2.7.4 / 2.3.3 Validation
firebase-admin 6.5.0 Server-side Firestore access
google-generativeai 0.7.2 Gemini API (model: models/gemini-2.5-flash, hardcoded in assistant.py)
xgboost 2.0.3 Used in experimental CVI scoring models (repointed to research-branch)
scikit-learn 1.5.0 Used in experimental MHS scoring models (repointed to research-branch)
numpy / pandas / joblib 1.26.4 / 2.2.2 / 1.4.2 Data handling / model I/O
twilio 9.2.3 SMS delivery — real integration in sms.py
python-jose[cryptography] 3.3.0 JWT
passlib[bcrypt] / bcrypt 1.7.4 / 4.1.3 Password hashing
httpx 0.27.0 Async HTTP client
python-dotenv 1.0.1 Env config
loguru 0.7.2 Logging
pytest / pytest-asyncio 8.2.2 / 0.23.7 Testing (1 backend test file, auth only)

Web App — web/ (React, separate from landing page)

React 19.2, Vite 8, TypeScript 6, react-router-dom 7, i18next + react-i18next + browser language detector, axios. No UI component library, no chart library yet.

Landing Page — landing-page/ (Next.js, separate app)

Next.js 16, React 19, Tailwind CSS 4, shadcn/ui, class-variance-authority, lucide-react, @vercel/analytics. Deployed at rhythma-navy.vercel.app.

CI/CD — .github/workflows/

GitHub Actions already configured for backend (pytest, path-filtered) and Flutter (flutter analyze + flutter test, path-filtered). No workflow yet for web/ or landing-page/.

⚠️ Known Issues (verified against current code)

  • Broken localization JSON: app_hi.arb, app_mr.arb, app_ta.arb, and app_te.arb contain a duplicated/malformed entry that makes them invalid JSON — this will break Flutter's ARB-based codegen until fixed. (app_en.arb, the base English file, is now valid.)
  • Cycle phase display bug: CycleProvider.phaseKey() in rhythma_flutter/lib/providers/cycle_provider.dart computes the menstrual phase from the calendar day of month (date.day) instead of the user's actual cycle day, and is used by cycle_screen.dart. A separate, correct method (phase(), scaled to the user's real cycle length) exists in the same file but isn't the one wired into the Cycle screen.
  • MHS is not yet ML-based: despite the original "Logistic Regression" description, it currently runs as a documented hand-written weighted average, with the lifestyle sub-score defaulting to a flat fallback value until profile fields ship (#112).
  • No offline auto-retry queue (#229): the sync-status indicator exists, but reconnect-triggered replay of queued writes does not yet.
  • Web app missing parity pages and CI (#247, #248).

Project Status

Legend: ✅ Done (real, working, verified against source) · 🟡 Partial (real code exists but incomplete, has a hardcoded piece, or is disconnected) · ❌ Not implemented (stub, placeholder, or absent)

Every row below was checked directly against the current backend/, rhythma_flutter/, web/, and landing-page/ source — not inferred from issue titles or an older status table.

Backend (FastAPI)

Item Status Notes
Auth: register / login / JWT / rate limiting ✅ core/auth_router.py — bcrypt hashing, rate-limited
Auth: refresh tokens / forgot-password / reset-password / email verification ✅ All five routes are live in auth_router.py (/refresh, /forgot-password, /reset-password, /verify-email, /resend-verification)
Cycle logging (POST /cycle/log, history) ✅ Real Firestore persistence
Quick-log (single-field upsert for Home screen tiles) ✅ Merged into the same log endpoint — partial payloads merge without overwriting other fields for that day
Dashboard (GET /dashboard) ✅ Real stats from logged data
Insights / scores (GET /insights/scores) ✅ Calls the shared scoring service, which itself calls the CVI and MHS models — these are exposed to the client, not backend-only research code
CVI model ✅ Trained XGBoost model shipped (cvi_model.joblib), heuristic fallback if the file is missing
MHS model 🟡 Hand-written weighted composite, not the planned Logistic Regression ensemble; lifestyle sub-score defaults to a flat 70.0 until profile fields land (#112)
AI Assistant (POST /assistant/chat) 🟡 Real Gemini call, real system prompt; conversation history is client-passed only (not persisted server-side), and it isn't grounded in a sourced medical dataset
SMS (api/sms.py) ✅ Real Twilio client, real rate limiting and phone validation
WhatsApp/Telegram bot ✅ api/bot.py (280 lines) + services/chatbot_service.py (246 lines) — full webhook handling, chat-linking, and a command engine (status, link, unlink, help)
Provider portal ✅ Register/login, consent grant/list/revoke, access log, patient list/detail
Health check endpoint ✅ Wired into main.py, distinguishes mock-mode from real Firestore
CORS config 🟡 Configurable via ALLOWED_ORIGINS env var, sane localhost defaults for dev — worth confirming this is actually set for prod deploys
Backend test coverage ✅ 42 test modules across auth, cycle, dashboard, insights, CVI/MHS, SMS, bot, provider, privacy
API documentation (OpenAPI descriptions) 🟡 /docs auto-generates; several routes still lack full descriptions/response models (#245)

Mobile (Flutter)

Item Status Notes
Core screens (Home, Cycle, Assistant, Insights, Profile, Settings, SMS, Onboarding, Auth) ✅ All present and routed
Auth service ✅ Real dio calls to backend /auth/*
Local storage (Hive) ✅ local_storage_service.dart
Encryption at rest ✅ Hive boxes are opened with HiveAesCipher, not just listed as a dependency
Firestore sync ✅ Offline-first via Hive, syncs when online
Sync status indicator ✅ SyncStatusProvider — synced/syncing/pending/offline/error
Automatic reconnect-and-retry queue 🟡 Status is tracked and shown; automatic replay of queued writes on reconnect isn't built yet (#229)
Local notifications ✅ notification_service.dart is wired to both period-prediction reminders and logging reminders, plus manual toggles in Settings
First-period / age-gated onboarding ✅ screens/education/first_period_education_screen.dart exists as a dedicated flow
Ayurvedic correlation content ✅ lib/data/ayurveda_content.dart — real content, merged via PR #436
Cycle phase calculation 🟡 Two implementations exist: phase() correctly scales to cycle length; phaseKey() — the one actually used by the Cycle screen — buggily uses calendar day-of-month instead
Localization — 17 Indian languages + English 🟡 Real .arb files for all 17; hi, mr, ta, and te contain malformed JSON that will break flutter gen-l10n until fixed. The base English file is valid
PDF report export ✅ pw.Document via pdf/printing
Widget/unit tests ✅ 25 test files

Web (web/ — React + TS + Vite)

Item Status Notes
App scaffold, routing, auth context ✅ AuthContext.tsx, protected routes
Login / Register pages ✅ Call the real backend
Home / Dashboard, Cycle, Assistant, Insights, Profile, Settings, SMS, Data Privacy, Sharing pages ✅ All exist with real implementations (100–489 lines each), not placeholders
Provider portal pages ✅ Login, register, dashboard, patient detail
i18n setup ✅ Configured
Test suite ✅ 34 test files, mocking at the API-client boundary and asserting on URL/payload
CI ✅ .github/workflows/web.yml exists

Landing Page (landing-page/ — Next.js)

Item Status Notes
Page, hero, features ✅ Live content
"Learn More" CTA ✅ Anchors to #features, works
"Get Started" CTA ❌ Renders as an <a href=""> with an empty href — currently a dead link, not a missing-handler <button>
CI ✅ .github/workflows/landing-page.yml exists

Cross-cutting

Item Status
CI — backend, Flutter, web, landing-page ✅ All four workflows exist in .github/workflows/
Architecture documentation ✅ docs/architecture.md
Medical sourcing / disclaimers docs ✅ docs/medical_sources.md, docs/health-disclaimers.md

This table is maintained by contributors alongside their PRs — see CONTRIBUTING.md → Documentation Guidelines. A PR that implements something listed here as ❌ or 🟡 should update the relevant row in the same PR.

Folder Structure

## 📂 Repository Structure

```text
Rhythma/
├── backend/                              # FastAPI backend
│   ├── api/                              # API routes
│   │   ├── assistant/
│   │   ├── bot/
│   │   ├── cycle/
│   │   ├── dashboard/
│   │   ├── health/
│   │   ├── insights/
│   │   ├── privacy/
│   │   ├── provider/
│   │   └── sms/
│   │
│   ├── core/                             # Authentication, middleware, security & validation
│   ├── data/                             # Medical reference datasets
│   ├── models/                           # ML models & database models
│   ├── scripts/                          # Utility & training scripts
│   ├── services/                         # Business logic & AI services
│   ├── tests/                            # 42 backend test modules
│   └── main.py                           # FastAPI application entrypoint
│
├── rhythma_flutter/                      # Flutter mobile application
│   ├── lib/
│   │   ├── components/                   # Shared reusable widgets
│   │   ├── config/                       # App configuration
│   │   ├── data/                         # Static datasets (Ayurveda, etc.)
│   │   ├── l10n/                         # 17 Indian language localizations
│   │   ├── models/
│   │   ├── providers/                    # State management
│   │   ├── screens/
│   │   │   ├── assistant/
│   │   │   ├── auth/
│   │   │   ├── cycle/
│   │   │   ├── education/
│   │   │   ├── home/
│   │   │   ├── insights/
│   │   │   ├── onboarding/
│   │   │   ├── profile/
│   │   │   ├── settings/
│   │   │   └── sms/
│   │   ├── services/                     # Storage, Firebase, notifications, reports
│   │   ├── utils/
│   │   └── main.dart
│   └── test/                             # Flutter test suite (25 tests)
│
├── web/                                  # React + TypeScript + Vite application
│   └── src/
│       ├── api/
│       ├── auth/
│       ├── components/
│       ├── i18n/
│       ├── lib/
│       ├── pages/
│       │   ├── AssistantPage
│       │   ├── CyclePage
│       │   ├── DataPrivacyPage
│       │   ├── HomePage
│       │   ├── InsightsPage
│       │   ├── LoginPage
│       │   ├── ProfilePage
│       │   ├── ProviderPages
│       │   ├── SettingsPage
│       │   ├── SharingPage
│       │   └── SmsPage
│       └── test/
│
├── landing-page/                         # Next.js marketing website
│   └── app/
│       ├── layout.tsx
│       ├── page.tsx
│       └── globals.css
│
├── docs/                                 # Project documentation
│   ├── architecture.md
│   ├── auth_refresh.md
│   ├── deploy_backend.md
│   ├── health-and-readiness.md
│   ├── health-disclaimers.md
│   ├── medical_sources.md
│   ├── menstrual_insights_guidelines.md
│   ├── phone_auth.md
│   └── Rhythma_Blog.docx
│
├── .github/
│   └── workflows/
│       ├── backend.yml
│       ├── flutter.yml
│       ├── landing-page.yml
│       └── web.yml
│
├── design-concepts/                      # UI prototypes & demo videos
├── screenshots/                          # App screenshots
├── requirements.txt                      # Python dependencies
├── LICENSE
└── README.md

Installation

Prerequisites

  • Flutter SDK 3.x
  • Python 3.10+
  • Node.js 18+ (only if you're working on web/ or landing-page/)
  • Git
  • A Firebase project (for backend user storage)
  • A Gemini API key (get one here)
  • A Twilio account (optional — only needed for SMS)
git clone https://github.com/ishita2740/Rhythma.git
cd Rhythma

Running Flutter

cd rhythma_flutter

# Platform folders are not committed — generate them first
flutter create .

flutter pub get

cp env.example .env
# Add GEMINI_API_KEY to .env to enable real AI responses
# (without it, the assistant falls back to a canned demo response)

# Add Firebase config files (see Firebase Setup below)
# android/app/google-services.json
# ios/Runner/GoogleService-Info.plist

flutter run

Running Backend

cd backend

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate

pip install -r ../requirements.txt

cp .env.example .env
# Fill in JWT_SECRET, Firebase credentials, and (optionally) GEMINI_API_KEY / Twilio credentials

uvicorn main:app --reload

The API will be available at http://127.0.0.1:8000, with interactive docs at http://127.0.0.1:8000/docs.

To run backend tests:

cd backend
pytest

Running the Web App

cd web
cp .env.example .env.local
# VITE_API_BASE_URL defaults to http://localhost:8000/api/v1, adjust if needed

npm install
npm run dev

Note: Both the Flutter app and the web app now require a real account. Register through either front end's Register screen against a running backend before you'll see anything past the login screen.

Running the Landing Page

cd landing-page
npm install
npm run dev

Configuration

Environment Variables

Backend (backend/.env)

Variable Required Purpose
JWT_SECRET Yes Signs and verifies auth tokens. App will not start without it.
FIREBASE_SERVICE_ACCOUNT_JSON or FIREBASE_SERVICE_ACCOUNT_PATH Yes (one of the two) Firebase Admin SDK credentials for Firestore access
GEMINI_API_KEY Optional Enables the backend's /assistant/chat endpoint
TWILIO_ACCOUNT_SID / TWILIO_AUTH_TOKEN / TWILIO_PHONE_NUMBER Optional Enables the /sms/send-summary endpoint

Flutter (rhythma_flutter/.env)

Variable Required Purpose
GEMINI_API_KEY Optional Enables real AI responses in the Assistant tab; without it, a demo fallback response is shown

Web (web/.env.local)

Variable Required Purpose
VITE_API_BASE_URL No — defaults to http://localhost:8000/api/v1 Backend base URL the web app calls for /auth, etc. Vite only exposes VITE_-prefixed vars to client code.

The backend's CORS config already whitelists the Vite dev server (http://localhost:5173) alongside localhost:8000/localhost:3000, so a default local setup works without touching main.py.

Firebase Setup

The backend currently uses Firebase only for user accounts and cycle data (via the Admin SDK). To set it up:

  1. Create a Firebase project at console.firebase.google.com.
  2. Generate a service account key: Project Settings → Service Accounts → Generate new private key.
  3. Either paste the resulting JSON into FIREBASE_SERVICE_ACCOUNT_JSON, or save the file and point FIREBASE_SERVICE_ACCOUNT_PATH at it.
  4. Ensure Firestore is enabled in the project (Native mode).

Note: The steps above cover the backend Firebase credentials. The Flutter app separately initializes Firebase on the client side (main.dart calls Firebase.initializeApp() and FirestoreService.init()), so client-side sync also needs the platform config files below.

Flutter Client Firebase Setup (Client-Side Firestore Sync)

For client-side offline-first Firestore synchronization (issue #27), the Flutter app needs its own Firebase config:

Android

  1. In the Firebase Console, add an Android app with package name com.example.rhythma.
  2. Download google-services.json and place it at: 
    rhythma_flutter/android/app/google-services.json
  3. android/app/build.gradle.kts and android/settings.gradle.kts are already configured with the google-services plugin.

iOS

  1. In the Firebase Console, add an iOS app with bundle ID com.example.rhythma.
  2. Download GoogleService-Info.plist and place it at: 
    rhythma_flutter/ios/Runner/GoogleService-Info.plist
  3. Add the file to the Xcode project if it is not already included.

App initialization

main.dart initializes Firebase and the sync service at startup:

await Firebase.initializeApp();
await FirestoreService.init();

This enables:

  • Offline persistence via Firestore's local cache
  • Automatic sync when connectivity is restored (issue #30)
  • SyncStatusProvider for the sync status indicator (issue #20)
  • Hive (local) remains the source of truth for reads; Firestore syncs when online and cloud sync is enabled

Future Features

These are explicitly not built yet — flagged here so contributors know what's scoped as future work rather than a current gap in an existing feature:

  • First Period Guidance — a simplified, age-appropriate onboarding and education flow for first-time users (12–17), distinct from the current adult-focused onboarding (onboarding_screen.dart). Tracked in issue #42.
  • WhatsApp Bot — a Gemini-powered WhatsApp assistant via Twilio/Meta Cloud API, so users on shared or low-end devices can track cycles and ask health questions without installing the app. No code for this exists anywhere in the repo yet.
  • Website feature parity — cycle tracking, AI Assistant, and Insights pages for web/, matching what the Flutter app already does. Auth and scaffolding exist today; the feature pages don't.
  • Ayurvedic correlation content — the educational content layer connecting lifestyle/cycle data to Ayurvedic wellness concepts. Tracked in issue #43; no content assets exist yet.
  • Provider-facing view — a dashboard for healthcare professionals to view (consenting) patients' longitudinal health data.
  • India regional health map — an anonymized, aggregated PCOD/PCOS risk heatmap for public-health and NGO use.

Contributing

Contributions are very welcome — code, docs, translations, design, and bug reports all matter.

Please read CONTRIBUTING.md before opening an issue or pull request. It covers project setup, branch naming, commit conventions, coding style, and the PR workflow in detail.

If you're looking for a place to start, the Project Status tables above double as a task list: anything marked ❌ or 🟡 is fair game.

License

This project is licensed under the MIT License. See LICENSE for details.

Acknowledgements

Disclaimer

Rhythma is intended for educational and preventive health awareness purposes only. It is not a certified medical device and does not provide medical diagnoses, prescriptions, or treatment recommendations. The cycle statistics and consistency observations provided by the application are for informational purposes only. The CVI and MHS models are legacy/experimental concepts under research and are not active user-facing features of the primary application. Any future Ayurvedic content will be educational and non-prescriptive, not a substitute for medical advice. Always consult a qualified healthcare professional for medical advice.

Built with 💜 by Ishita Rathi for the women India's apps forgot.

AI For Every Phase of Her Health.

About

AI-powered multilingual women's health companion focused on menstrual health, wellness guidance, and accessible healthcare information.

rhythma-navy.vercel.app

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

7 stars

Watchers

0 watching

Forks

48 forks
Report repository

Releases

Packages

Contributors

Languages