VoteWise 🗳️

AI-powered civic education for Indian voters. Understand elections, register to vote, and test your knowledge.

Built for PromptWars Virtual Hackathon using Google Antigravity IDE + Gemini AI.

---

✨ Features

Feature	Description
🗓️ Election Timeline	Visual 6-phase guide to how India conducts general elections
📋 Voter Guide	Step-by-step voter registration walkthrough with official ECI links
💬 Ask VoteWise	AI chat powered by Gemini — ask anything about Indian elections
🧠 Civic Quiz	AI-generated MCQ quiz with instant grading and explanations

---

🛠️ Tech Stack

Frontend

• React 19 + Vite 8
• Tailwind CSS v3
• React Router DOM

Backend

• Python FastAPI
• Google GenAI SDK (google-genai)
• Uvicorn + python-dotenv

AI

• Google Gemini 2.5 Flash Lite
• System-prompted civic educator persona
• AI quiz generation + grading

Built With

• Google Antigravity IDE (agentic AI coding)

---

🚀 Run Locally

Prerequisites

• Node.js 18+
• Python 3.12+
• Google Gemini API key (free at ai.google.dev)

Backend

cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# create .env
cp .env.example .env
# add your GEMINI_API_KEY to .env

uvicorn main:app --reload
# runs on http://localhost:8000

Frontend

cd frontend
npm install

# create .env
cp .env.example .env
# VITE_API_URL=http://localhost:8000

npm run dev
# runs on http://localhost:5173

---

📁 Project Structure

votewise/
├── backend/
│   ├── main.py           # FastAPI routes
│   ├── gemini.py         # Gemini AI integration
│   ├── election_data.py  # India election content
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── pages/        # Timeline, VoterGuide, Chat, Quiz
│   │   ├── components/   # Navbar, StepCard
│   │   └── lib/api.js    # API layer
│   └── vite.config.js
└── project-docs/         # Architecture, coding rules, context

---

🇮🇳 Why VoteWise?

India has one of the world's most complex election systems — 543 Lok Sabha constituencies, multi-phase voting, EVMs, VVPAT, Model Code of Conduct, and millions of first-time voters every election cycle who don't know where to start.

VoteWise makes it simple. No jargon. No government-website UX. Just clear, AI-powered civic education.

---

🏆 Hackathon

This project was built for PromptWars Virtual Hackathon under the Election Process Education challenge.

Built entirely using Google Antigravity IDE — an agentic AI coding environment — with Gemini handling both the development assistance and the in-app AI features.

---

👤 Author

manasscodes
github.com/manasscodes

---

📄 License

MIT — free to use, learn from, and build on.