Skip to content

Maha Mantra Learning Studio

Maha Mantra Learning Studio is an AI-powered devotional music practice platform that guides users through structured mantra chanting using Gemini.

Code Video Cerebral Valley

Core trick

Gemini scores live chant recordings for discipline and resonance, stepping the learner through five stages to independent singing.

Tags

creative/musiceducation

Description

Maha Mantra Learning Studio is an AI-powered devotional music practice platform that guides users through structured mantra chanting using Gemini. Practitioners progress through a 5-stage flow — Listen, Guided Follow-Along, Call-Response, Performance Recap, and Independent Singing — while Gemini scores their discipline, resonance, and coherence in real time and computes a "Bhav" (devotional quality) assessment tuned to their lineage tradition. Deployed Link: https://gemini-music-api-823803257486.us-central1.run.app Loom Demo: https://www.loom.com/share/0a742dd6041b4ac9a0a6a586d6ee7461
ChaiWithJai/gemini-music★ 00 forksPythonCreated Feb 28, 2026 · last push Feb 28, 2026

README excerpt

# Gemini Music

Real-time personalized mantra learning + AI-assisted kirtan using adaptive signals from listener input, optional biometrics, and environment context.

## Day 0 Story (Clone -> Run -> Contribute -> Merge -> Release)

1. Clone and enter the repo.
```bash
git clone git@github.com:ChaiWithJai/gemini-music.git
cd gemini-music
```

2. Bootstrap a known-good local environment.
```bash
./scripts/day0.sh
```

3. Start the API and open local docs.
```bash
cd api
make run
# open http://localhost:8000/docs
# open http://localhost:8000/poc/
# open http://localhost:8000/demo/
```

4. Make a contribution on a feature branch.
```bash
git checkout -b codex/<short-feature-name>
# edit code/docs
cd api
make ci
```

5. Push and open a PR.
```bash
git add -A
git commit -m "feat: <what changed>"
git push -u origin HEAD
gh pr create --fill
```

6. Merge after checks pass.
```bash
gh pr merge --squash --delete-branch
```

7. Cut a release from `main`.
```bash
cd ..
./scripts/release.sh v0.2.0
```

8. Rehearse executive demo + build submission dossier.
```bash
./scripts/rehearse_demo.sh
./scripts/build_submission_dossier.sh
```

## Developer Commands

From `api/`:

- `make doctor`: verify Python 3.13 toolchain and venv compatibility
- `make bootstrap`: create/recreate `.venv` for Python 3.13
- `make install`: install dependencies
- `make test`: run unit and API tests
- `make evals_all`: run full scorecard eval set
- `make goal_test`: run focused goal scenario and produce single JSON s

Team