Pakistan Constitution AI Chatbot

An AI-powered chatbot that answers questions about the Constitution of Pakistan using RAG (Retrieval Augmented Generation) with Pinecone vector database and Google Gemini.

🏗️ Project Structure

pak_constitution/
├── backend/           # FastAPI backend
│   ├── backend.py     # Main API server
│   ├── requirements.txt
│   └── .env.example   # Environment variables template
├── frontend/          # Next.js frontend
│   ├── app/
│   │   ├── page.tsx       # Main chat page
│   │   ├── contact/       # Contact page
│   │   ├── layout.tsx
│   │   └── globals.css
│   ├── package.json
│   └── ...config files
└── README.md

🚀 Features

RAG-based Q&A: Uses Pinecone for semantic search and Gemini for answer generation
ChatGPT-style UI: Clean, modern interface with sidebar navigation
Responsive Design: Works on desktop and mobile
Pakistan Theme: Green color scheme inspired by Pakistan's flag

🛠️ Setup

Backend (FastAPI)

Navigate to backend folder:
```
cd backend
```

Create virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:
```
pip install -r requirements.txt
```
Create .env file from example:
```
cp .env.example .env
```

Add your API keys to .env:

PINECONE_API_KEY=your_pinecone_api_key
GEMINI_API_KEY=your_gemini_api_key

Run the server:
```
uvicorn backend:app --reload
```

Backend will be available at http://localhost:8000

Frontend (Next.js)

Navigate to frontend folder:
```
cd frontend
```
Install dependencies:
```
npm install
```

Create .env.local file:

NEXT_PUBLIC_API_URL=http://localhost:8000

Run development server:
```
npm run dev
```

Frontend will be available at http://localhost:3000

🌐 Deployment

Backend on Railway

Push to GitHub
Connect Railway to your GitHub repo
Add environment variables in Railway dashboard
Deploy!

Frontend on Vercel

Push to GitHub
Import project in Vercel
Set NEXT_PUBLIC_API_URL to your Railway backend URL
Deploy!

📝 API Endpoints

POST /ask - Ask a question about the Constitution

{
  "question": "What are the fundamental rights?"
}

GET /health - Health check endpoint

🛡️ Tech Stack

Backend: FastAPI, Pinecone, Google Gemini
Frontend: Next.js 16, Tailwind CSS, TypeScript
Vector DB: Pinecone (llama-text-embed-v2)
LLM: Google Gemini 2.5 Flash

👨‍💻 Developed By

Echytech Solutions

Made with ❤️ for Pakistan

SeekAI-786/Pak_Constitution_chatbot