---
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