Skip to content

sinarest1608/inneroracle

Repository files navigation

🪔 InnerOracle

Life questions, answered only from the Bhagavad Gita & the Ashtavakra Gita — with every claim cited to the verse it came from.

InnerOracle — welcome screen


What it is

InnerOracle is a grounded AI assistant for life questions. Instead of answering from a model's general knowledge, it retrieves relevant verses from two classical wisdom texts — the Bhagavad Gita and the Ashtavakra Gita — and answers strictly from them, citing each claim inline. When the two texts disagree, it shows both perspectives rather than blending them. When the texts don't cover something, it says so instead of guessing.

Ask anything — "How do I deal with anxiety about results?", "What is the self?", "How should I handle anger?" — and get a concise, sourced answer you can trace back to the original Sanskrit.

What makes it different

  • 📖 Grounded, not guessed — answers come only from the retrieved verses. Every substantive claim carries an inline citation like [BG 2.47] or [AG 1.15].
  • ✅ Self-checking — a separate model verifies each answer against the source verses and shows a "grounded in the texts" / "check sources" badge, so you know how trustworthy it is.
  • 🔍 Tap to see the shloka — tap any citation to reveal the original Devanagari verse, transliteration, and translation.
  • ⚖️ Honest contrast — the Gita's path of selfless action vs. the Ashtavakra Gita's non-dual "you were never the doer" — presented side by side. Focus on one text or compare both.
  • 💬 Remembers the conversation — ask follow-ups like "tell me more" or "what about anger?" and it keeps context.
  • 🔒 Private by design — conversations live only in your browser; nothing is stored on a server.

See it in action

A grounded answer — inline citations to each verse and a "grounded in the texts" verification badge. Light and dark themes:

Grounded answer — light theme Grounded answer — dark theme

Welcome screen — dark theme:

Welcome screen — dark theme

On mobile:

InnerOracle on mobile

How it works

your question
   → (for follow-ups) rewritten into a standalone search query
      → hybrid retrieval: dense semantic + keyword search, fused and balanced across both texts
         → the model writes a concise answer grounded in those verses, streamed live
            → a verifier checks the answer against the verses → "grounded" / "check sources" badge

Sanskrit shlokas are kept separate from translations and commentary when the texts are ingested, then recombined into full verse context at answer time — so retrieval stays precise while answers stay readable.

Built with

Retrieval-Augmented Generation · Anthropic Claude (answers + verification) · FastAPI with live token streaming · Qdrant hybrid vector search (semantic + keyword, RRF fusion) · ONNX embeddings · SQLite · a dependency-light vanilla-JS web app · deployed with Docker behind a Cloudflare Tunnel.


Made with care for the texts. Answers are for reflection, not a substitute for a teacher.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors