🕉️ Application Screenshot

Experience spiritual conversations with Lord Krishna through our beautiful, modern interface featuring multi-conversation support, Sanskrit verses, and real-time chat.

Śrī Kṛṣṇa, bearer of the Gītā's eternal light - An AI-powered spiritual companion sharing the timeless wisdom of the Bhagavad Gita through conversational AI.

📱Overview

GeetaGPT is a sophisticated chatbot application that embodies the persona of Lord Krishna, offering spiritual guidance and wisdom from the Bhagavad Gita. Built with modern web technologies, it provides an immersive conversational experience with advanced session management and beautiful UI.

✨ Features

🎯 Core Features

• Krishna AI Persona: Responds as Lord Krishna with spiritual wisdom
• Multi-Conversation Support: Create and manage multiple chat sessions
• Real-time Chat: Instant messaging with typing indicators
• Session Persistence: Conversations are remembered across sessions
• Search Functionality: Find specific conversations quickly

🧠 Technical Features

• LangGraph Integration: Advanced conversation memory and state management
• Google Gemini AI: Powered by cutting-edge language models
• Thread-based Sessions: Each conversation maintains independent context

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    GEETAGPT ARCHITECTURE                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Frontend (React + TypeScript)     Backend (FastAPI + Python)   │
│  ┌─────────────────────────┐       ┌─────────────────────────┐  │
│  │ • React 18 + Vite       │◄─────►│ • FastAPI Server        │  │
│  │ • TypeScript            │ HTTP  │ • LangGraph Workflows   │  │
│  │ • Shadcn/ui Components  │ API   │ • Google Gemini AI      │  │
│  │ • Multi-conversation    │       │ • Memory Management     │  │
│  │ • State Management      │       │ • Session Handling      │  │
│  └─────────────────────────┘       └─────────────────────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• Python (3.8 or higher)
• Google AI API Key (for Gemini AI)

Backend Setup

1. Navigate to Backend directory:

   cd Backend

2. Install Python dependencies:

   pip install fastapi uvicorn langchain-google-genai langgraph python-dotenv

3. Create environment file:

   touch .env

4. Add your Google AI API key to .env:

   GOOGLE_API_KEY=your_google_ai_api_key_here

5. Start the backend server:

   python main.py

   The API will be available at http://localhost:8000

Frontend Setup

1. Navigate to project root:

   cd ..

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   The app will be available at http://localhost:5173

🔧 API Documentation

Backend Endpoints

GET /health

Check if the backend server is running.

Response:

{
  "status": "healthy",
  "message": "Backend is online",
  "timestamp": "uuid-string"
}

POST /chat

Send a message to Krishna AI.

Request:

{
  "message": "What is dharma?",
  "thread_id": "thread-uuid-string"
}

Response:

{
  "reply": "Dharma is your righteous duty...",
  "thread_id": "thread-uuid-string",
  "status": "success"
}

🎛️ Configuration

Environment Variables

Backend (.env):

GOOGLE_API_KEY=your_google_ai_api_key_here

Frontend Configuration

Vite Configuration (vite.config.ts):

• Hot reload enabled
• TypeScript support
• Path aliases configured (@/ points to src/)

🧠 How It Works

1. Session Management

Each conversation gets a unique thread ID (thread-{uuid}):

const threadId = `thread-${uuidv4()}`;

2. AI Memory

LangGraph maintains conversation context per thread:

config = {
    "configurable": {
        "thread_id": thread_id  # Unique per conversation
    }
}

3. State Flow

User Message → Frontend → API Call → LangGraph → Gemini AI → Response → Frontend → UI Update

4. Multi-Conversation Architecture

• Frontend manages multiple conversation threads
• Each thread maintains independent message history
• Backend uses thread IDs for memory isolation
• Seamless switching between conversations

📚 Technologies Used

Frontend:

• React 18 - UI framework
• TypeScript - Type safety
• Vite - Build tool
• Shadcn/ui - UI component library
• Radix UI - Headless components
• Tailwind CSS - Styling
• Lucide React - Icons
• date-fns - Date formatting

Backend:

• FastAPI - Python web framework
• LangGraph - Conversation workflows
• LangChain - AI integration
• Google Gemini AI - Language model
• Uvicorn - ASGI server

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit changes: git commit -m 'Add amazing feature'
4. Push to branch: git push origin feature/amazing-feature
5. Open a Pull Request

🙏 Acknowledgments

• Bhagavad Gita - Source of eternal wisdom
• OpenAI/Google - AI technology
• React & FastAPI Communities - Amazing frameworks
• Shadcn/ui - Beautiful component library

🕉️ Hare Krishna! May this tool help you on your spiritual journey. 🪷

"You have the right to perform your prescribed duty, but not to the fruits of that action. Never consider yourself the cause of the results of your activities, and never be attached to not doing your duty." - Bhagavad Gita 2.47