🏛️ GovAssist — AI-Powered Government Scheme Platform

GovAssist is a premium, portfolio-ready web application designed to bridge the gap between citizens and Indian government welfare schemes. By leveraging Retrieval-Augmented Generation (RAG), dynamic web scraping, and automated document analysis, the platform democratizes access to social welfare.

---

🔗 Live Preview

🌍 Explore the frontend interface: GovAssist live Demo

---

📸 Application Screenshots

Here is a visual walk-through of the premium, responsive glassmorphism interface:

🏠 1. Interactive Landing Page

Featuring dynamic canvas particle animations, scroll reveals, and high-contrast color choices.

💬 2. AI Chatbot (RAG Engine)

Multilingual conversational interface with message editing, session sharing, and source references.

📋 3. Government Scheme Discovery & Filtering

Browse through schemes categorized by ministry, target demographic, and search parameters.

🧠 4. Interactive Eligibility Checker

Input personal profile criteria to instantly calculate eligibility scores and export official PDF reports.

📄 5. AI Document Verification & OCR

Upload PDF or image files to extract details via OCR and check document validity for specific schemes.

⚙️ 6. Real-Time DevOps Command Center (Admin / Owner Dashboard)

Monitor database connections, toggle scraper services, and enable/disable AI engines using feature flags on the fly.

---

⭐ Key Features

• 🌐 Complete Multilingual Suite: Seamless, instant language switching across English, Hindi, and Marathi, backed by a custom on-screen virtual keyboard for regional inputs.
• 🗣️ Integrated Voice Search: Users can interact via speech, converting voice inputs into text using backend Whisper AI transcription.
• 📄 Print-Engine Export: Clean CSS-injected PDF report generator that formats eligibility cards into an official government-style paper document without watermark bloat.
• 🚀 DevOps Feature Flags: Control heavy database scraping, Google Gemini AI usage, or cloud file-uploads in real-time from the Owner Dashboard without code redeployment.
• 🔒 Rate Limiting & Hashing: Protected endpoints using SlowAPI (60 requests/minute limit) and bcrypt-hashed authentication.

---

🛠️ Technology Stack

GovAssist is built using an enterprise-ready, modular architecture:

Component	Technology	Description
Frontend	React 18, Vite, Tailwind CSS, Lucide Icons, Framer Motion	High-performance, responsive UI with smooth transitions and particle systems.
Backend	Python 3.10+, FastAPI, SlowAPI, PyJWT	Lightweight, scalable API layer supporting asynchronous execution.
Database	SQLAlchemy, SQLite (Local Fallback), PostgreSQL	Flexible relational mapping with safe database transactions.
AI / NLP	Google Gemini API (google-generativeai), LangChain, FAISS	Vector retrieval (RAG) and conversational context memory windowing.
Parsing & OCR	Tesseract OCR, PyMuPDF, Python-docx	File parsing and text extraction engine for PDFs, images, and documents.

---

🚀 Getting Started

Prerequisites

Make sure you have the following installed on your machine:

• Node.js (v18+)
• Python (v3.10+)

---

1. Automated Quick Start (Windows)

The repository includes a helper script that automates environment setup, dependency installs, port allocations, and server start-ups:

./install_and_run.bat

This script will:

1. Verify / install Python & Node.js on Windows.
2. Initialize python virtual environment (venv) and install pip packages.
3. Install frontend node modules.
4. Launch the FastAPI backend on port 8001.
5. Launch the Vite frontend on port 5102 and automatically open it in your browser.

---

2. Manual Installation & Setup

Backend Setup

1. Navigate to the backend directory:

   cd backend

2. Create and activate a Python virtual environment:

   python -m venv venv
   # On Windows (PowerShell):
   .\venv\Scripts\Activate.ps1
   # On macOS/Linux:
   source venv/bin/activate

3. Install required packages:

   pip install -r requirements.txt

4. Create a .env file in the backend/ root directory and add your credentials:

   GEMINI_API_KEY=your_google_gemini_api_key_here
   SECRET_KEY=your_jwt_auth_secret_key_here

5. Start the FastAPI development server:

   python -m uvicorn app.main:app --reload --port 8001

Frontend Setup

1. Navigate to the frontend directory:

   cd frontend

2. Install npm packages:

   npm install

3. Start the Vite development server:

   npm run dev -- --port 5102

4. Open your browser and navigate to http://localhost:5102.

---

🔒 Administrative & Owner Roles

For local evaluation, the application includes the preconfigured developer/owner credentials:

• Developer/Owner: pattiwarrushikesh5102@gmail.com | Rushikesh@5102 (Accesses the DevOps Command Center and Admin panels)

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.