production deployment

Dockerfile

@@ -0,0 +1,47 @@
+# Dockerfile for Bhagwad Gita RAG Chatbot on Hugging Face Spaces
+# Based on: https://huggingface.co/docs/hub/spaces-sdks-docker
+
+FROM python:3.9-slim
+
+# Set up a new user named "user" with user ID 1000 (HF Spaces requirement)
+RUN useradd -m -u 1000 user
+
+# Switch to the "user" user
+USER user
+
+# Set home to the user's home directory
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+# Set the working directory to the user's home directory
+WORKDIR $HOME/app
+
+# Try and run pip command after setting the user to avoid permission issues
+RUN pip install --no-cache-dir --upgrade pip
+
+# Copy requirements first for better caching
+COPY --chown=user requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy the current directory contents into the container
+COPY --chown=user . .
+
+# Create data directory and ensure proper permissions
+RUN mkdir -p dataset && chmod 755 dataset
+
+# Expose the port that HF Spaces expects (7860)
+EXPOSE 7860
+
+# Set environment variables for HF Spaces
+ENV API_HOST=0.0.0.0
+ENV API_PORT=7860
+ENV ENVIRONMENT=production
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7860/health || exit 1
+
+# Start the FastAPI application on port 7860 (HF Spaces requirement)
+CMD ["uvicorn", "backend.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,11 +1,90 @@
 ---
-title: Indian Mythology Chatbot
-emoji: 🐢
-colorFrom: gray
-colorTo: pink
+title: Bhagwad Gita RAG Chatbot
+emoji: 🕉️
+colorFrom: purple
+colorTo: indigo
 sdk: docker
-pinned: false
-license: mit
+app_port: 7860
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🕉️ Bhagwad Gita RAG Chatbot
+
+An intelligent chatbot that provides wisdom from the Bhagavad Gita and Patanjali Yoga Sutras using advanced RAG (Retrieval Augmented Generation) technology.
+
+## 🌟 Features
+
+- **Sacred Text Querying**: Ask questions and get relevant verses from Bhagavad Gita and Patanjali Yoga Sutras
+- **Intelligent RAG**: Uses TF-IDF and cosine similarity for accurate verse matching
+- **Automatic Summaries**: Get concise explanations of complex spiritual concepts
+- **Bilingual Support**: Sanskrit and English language support
+- **Interactive API**: Full REST API with Swagger documentation
+
+## 🚀 Quick Start
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://huggingface.co/spaces/AbhavBhanot/Indian-Mythology-Chatbot
+   cd Indian-Mythology-Chatbot
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. **Run the application**:
+   ```bash
+   python backend/main.py
+   ```
+
+4. **Access the API**:
+   - Main API: http://localhost:8000
+   - Interactive Docs: http://localhost:8000/docs
+   - Health Check: http://localhost:8000/health
+
+## 📚 API Endpoints
+
+- `GET /` - Main landing page
+- `GET /health` - Health check
+- `POST /query` - Process spiritual queries
+- `GET /sources` - Get available text sources
+- `POST /translate` - Translate text between languages
+- `GET /supported-languages` - List supported languages
+
+## 🐳 Docker Deployment
+
+This project is configured for deployment on Hugging Face Spaces using Docker. The Dockerfile automatically:
+
+- Sets up the Python environment
+- Installs all dependencies
+- Configures the FastAPI application
+- Exposes the service on port 7860
+
+## 🔧 Configuration
+
+Set these environment variables for customization:
+
+- `DATA_DIR`: Path to dataset directory
+- `CORS_ORIGINS`: Allowed CORS origins
+- `API_HOST`: API host (default: 0.0.0.0)
+- `API_PORT`: API port (default: 8000)
+
+## 📖 Dataset Structure
+
+The chatbot uses structured CSV datasets containing:
+- Bhagavad Gita verses in Sanskrit and English
+- Patanjali Yoga Sutras
+- Word meanings and translations
+- Question-answer pairs for training
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+**Built with ❤️ for spiritual seekers and knowledge enthusiasts**

app.py

@@ -0,0 +1,17 @@
+"""
+Entry point for Hugging Face Spaces deployment
+This file imports and runs the main FastAPI application from the backend
+"""
+
+import sys
+import os
+from pathlib import Path
+
+# Add the current directory to Python path so we can import from backend
+sys.path.insert(0, str(Path(__file__).parent))
+
+# Import the FastAPI app from backend.main
+from backend.main import app
+
+# The app variable is what HF Spaces will use to run the application
+# No need to run uvicorn here - HF Spaces handles that automatically

dockerignore

@@ -0,0 +1,64 @@
+# Git and version control
+.git
+.gitignore
+.gitattributes
+
+# Documentation
+README.md
+*.md
+docs/
+
+# Development files
+.env
+.env.local
+.env.production
+*.log
+*.pyc
+__pycache__/
+.pytest_cache/
+.coverage
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Node.js (if any)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Large data files (will be mounted at runtime)
+# dataset/
+
+# Docker files
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Deployment files
+render.yaml
+netlify.toml
+build_production.sh

requirements-hf.txt

@@ -0,0 +1,29 @@
+# Requirements for Hugging Face Spaces deployment
+# Optimized for faster builds and smaller image size
+
+# Core FastAPI dependencies
+fastapi
+uvicorn[standard]
+pydantic
+
+# Data processing
+pandas
+numpy
+scikit-learn
+
+# ML/AI dependencies (CPU-only for HF Spaces)
+torch
+torchvision
+torchaudio
+transformers
+accelerate
+sentencepiece
+
+# Utility libraries
+python-multipart
+jinja2
+python-dotenv
+aiofiles
+
+# Add curl for health checks
+curl