Geetanjali
Ethical leadership guidance from the Bhagavad Geeta.
Geetanjali helps you think through tough decisions by connecting your dilemmas to wisdom from 701 verses of the Bhagavad Geeta. It also lets you explore the scripture at your own pace — browse, search, or read cover to cover.
Free. Open source. Private by default.
Two Ways to Use Geetanjali
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ FACING A DILEMMA? WANT TO LEARN? │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────────────────┐ ┌─────────────────────────┐ │
│ │ CONSULTATION │ │ DISCOVERY │ │
│ │ │ │ │ │
│ │ Describe your │ │ Browse 701 verses │ │
│ │ situation │ │ across 18 chapters │ │
│ │ ↓ │ │ ↓ │ │
│ │ AI retrieves relevant │ │ Read sequentially or │ │
│ │ verses from scripture │ │ search by meaning │ │
│ │ ↓ │ │ ↓ │ │
│ │ Get structured options │ │ Sanskrit + translation │ │
│ │ with verse citations │ │ + modern insights │ │
│ │ ↓ │ │ ↓ │ │
│ │ Ask follow-ups to │ │ Save favorites, track │ │
│ │ refine guidance │ │ reading progress │ │
│ │ │ │ │ │
│ └─────────────────────────┘ └─────────────────────────┘ │
│ │
│ No hallucinated quotes — every recommendation cites │
│ actual verses. Runs locally. Works offline. │
│ │
└─────────────────────────────────────────────────────────────────────┘
Consultation — You have a tough decision. Layoffs? Whistleblowing? Conflicting loyalties? Describe it, get three options with tradeoffs, each grounded in specific verses. Continue the conversation until you’re clear.
Discovery — You want to understand the Geeta. Browse by chapter, search by concept, or read cover to cover in Reading Mode. Sanskrit text with transliteration, multiple translations, and plain-language insights.
Both paths. Same 701 verses. Your pace, your privacy.
Quick Start
Run Geetanjali locally in under 5 minutes:
git clone https://github.com/geetanjaliapp/geetanjali.git
cd geetanjali
git lfs pull # Audio files
docker compose up -d
docker exec geetanjali-ollama ollama pull qwen2.5:3b
Open http://localhost to start exploring.
For development setup, see the Setup Guide.
Deep Dive
Building Geetanjali — The full story. How we built a RAG system that grounds ethical guidance in scripture. Two user journeys, architecture decisions, and why local-first matters.
How It Works
Understand what users experience:
- Consultation Journey — Submit a dilemma, get structured guidance with verse citations
- Discovery Journey — Browse verses, read chapters, explore at your pace
- Search — Find verses by reference, Sanskrit text, keywords, or meaning
- Audio Recitations — AI-generated Sanskrit verse recitations
Design & Architecture
How we built it:
- Architecture — System components, RAG pipeline, data flow
- Design — Frontend design language, colors, typography, responsive patterns
- Theming — CSS token architecture, theme customization, adding new themes
- Operations — Consultation flow, processing states, async handling
- Content Moderation — Multi-layer filtering, keeping focus on real dilemmas
Running It
For operators and contributors:
- Setup Guide — Local development, environment variables, common commands
- Deployment — Docker Compose, deployment modes, container orchestration
- Content Management — Scripts, data files, audio generation, admin API
- Security — Container hardening, secrets management, incident response
- Observability — Prometheus metrics, Grafana dashboards, alerting
- Troubleshooting — Common issues and quick fixes
- Accessibility QA — Manual testing checklist for screen readers and keyboard
Reference
- API Reference — REST API endpoints, authentication, rate limits, examples
- Reference — Environment variables, error codes, glossary, scripts
- Data Sources — Bhagavad Geeta content, licensing, ingestion pipeline
- SEO — Bot-served static HTML for search engine visibility
About
- About Geetanjali — Vision, principles, FAQ, and accessibility statement
Live: geetanjaliapp.com · Source: GitHub