TatTwamAI / README.md
Jayashree Sridhar
updated readme
9b66378

A newer version of the Gradio SDK is available: 5.42.0

Upgrade
metadata
title: TatTwamAI
emoji: πŸš€
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.19.2
app_file: app.py
pinned: false

README.md

agent-demo-track

🧭 Tat Twam AI β€” A Multi-Agent AI Coach for Personal and Spiritual Growth

Tat Twam AI is an intelligent multi-agent application that serves as a personal, non-judgmental AI coach. Designed for individuals navigating life's personal and professional dilemmas, Tat Twam AI combines cutting-edge AI frameworks with timeless wisdom from classic spiritual and modern self-help texts.

The product is designed to provide calming, insightful, and personalized guidance through a soothing, human-like conversationβ€”helping users reflect, grow, and find direction.


🌟 Key Features

  • πŸŽ™οΈ Accepts voice input in user's mother tongue or text input in English
  • πŸ’¬ Engages users with soothing, reflective dialogue
  • πŸ“š Draws wisdom from 13 timeless spiritual and self-help texts
  • πŸ€– Built on a multi-agent architecture using state-of-the-art LLM tools
  • πŸ” Offers context-aware, personalized suggestions with guardrails
  • πŸ§˜β€β™€οΈ Responds in a calm, meditative voice, promoting inner peace

🧩 System Architecture

The core logic of Tat Twam AI is implemented using four intelligent agents, each responsible for a specific part of the coaching journey:

🧠 Agent 1: The Listener & Summarizer

  • Input: Voice (in user's mother tongue) or text (in English)
  • Functionality:
    • Converts speech to English text
    • Conducts a gentle Q&A session to uncover the user’s core problem
    • Summarizes the conversation
    • Analyzes tone and emotional sentiment
  • Tools:
    • ASR (Speech-to-text) with multilingual support
    • Sentiment analysis
    • Conversational Q&A
    • Summary generator

πŸ“˜ Agent 2: The Wisdom Engine

  • Input: Summary, tone, and sentiment from Agent 1
  • Functionality:
    • Retrieves spiritual or self-help insights using a RAG (Retrieval-Augmented Generation) system
    • Offers customized reflections, techniques, or meditations relevant to the user’s current issue
  • Knowledge Base Includes:
    1. Autobiography of a Yogi
    2. Gita Vahini
    3. The Power of Now
    4. Man's Search for Meaning
    5. Bhagavad Gita As It Is
    6. Meditations (Marcus Aurelius)
    7. The Tao Te Ching
    8. Dhyana Vahini
    9. Atomic Habits
    10. The 7 Habits of Highly Effective People
    11. Mindset (Carol Dweck)
    12. Prema Vahini
    13. Prasnothara Vahini
  • Tools: Custom RAG pipeline + embedding-based retrieval + fine-tuned LLMs

πŸ›‘ Agent 3: The Inner Critic & Guardian

  • Input: Suggested output from Agent 2
  • Functionality:
    • Implements guardrails to ensure spiritual, ethical, and emotional appropriateness
    • Adjusts tone and verifies factuality, empathy, and personalization
    • Converts final output to voice with a mild, meditative female tone
  • Tools: LLM-as-Judge, Voice synthesis

πŸ”„ Agent 4: The Satisfaction Checker

  • Functionality:
    • Asks for user satisfaction and feedback
    • Decides whether to continue or close the session
    • Passes feedback to Agent 1 for context-aware follow-up
  • Tools: User feedback processing, memory/context management

πŸ’¬ Sample Flow

  1. User speaks: β€œI feel lost about my career direction.” (in Hindi)
  2. Agent 1: Asks reflective questions like: β€œWhat matters most to you right now?”
  3. Agent 2: Responds with insights from The Power of Now and Gita Vahini
  4. Agent 3: Ensures calm, helpful delivery in a soothing voice
  5. Agent 4: Asks: β€œDid that help you gain clarity?” β†’ If yes, ends. If no, loop continues.

🎯 Vision

Tat Twam AI aspires to be your non-judgmental companion for inner clarity, integrating deep ancient wisdom with today's AI technology. Its goal is not to give you answers, but to gently guide you inward to find your own.


🚧 Coming Soon

  • πŸ“± Mobile app with voice interface
  • 🧾 Journaling feature synced with conversation history
  • πŸ”„ Multi-language support for responses
  • πŸ”’ End-to-end encryption and privacy-first design

πŸ“¬ Contact

Interested in collaborating, contributing, or piloting this application? Reach out at [saishree999@gmail.com]


"The answers you seek will come when your mind is quiet enough to hear them." β€”Tat Twam AI