Empowering Indian citizens with AI-driven, non-partisan, and accessible election guidance.
Chunaav AI is an intelligent assistant designed to simplify the complexities of the Indian election process. Built for the modern citizen, it provides a guided, multi-turn conversational journey to ensure that every eligible voice is heard.
From checking eligibility to navigating the polling booth, Chunaav AI leverages the cutting-edge Gemini 2.5 Flash model to provide instant, accurate, and multi-lingual support.
- 🗺️ Personalized Voting Journey: A step-by-step interactive stepper that tracks your progress from registration to casting your vote.
- 🤖 Gemini 2.5 AI Assistant: Real-time conversational agent supporting English and Hindi (Devanagari).
- 📅 Dynamic Election Timeline: Stay updated with critical dates, registration deadlines, and phase-wise voting schedules.
- 🛡️ Enterprise-Grade Security: Hardened with CSP, CSRF protection, and secure secret management via Google Cloud.
- ♿ WCAG Accessible: Designed with inclusivity in mind, featuring ARIA labels, semantic structure, and keyboard navigation.
- Framework: React 18 + Vite
- Styling: Tailwind CSS (Glassmorphism & Premium UI)
- State Management: Zustand
- Animations: Framer Motion
- Icons: Lucide React
- Framework: FastAPI (Asynchronous Python)
- AI Engine: Google Gemini 2.5 Flash (
google-genaiSDK) - Infrastructure: Google Cloud Run, Cloud Logging, Secret Manager
- Performance: GZip compression, In-memory Caching
- Python 3.9+
- Node.js 18+
- Google Gemini API Key
cd backendpython -m venv venvsource venv/bin/activate(or.\venv\Scripts\activateon Windows)pip install -r requirements.txt- Create
.env:GOOGLE_API_KEY=your_key uvicorn main:app --reload
cd frontendnpm installnpm run dev
The project is optimized for Google Cloud Run.
# Deploy using Google Cloud Build
gcloud run deploy chunaav-ai --source . --region us-central1- Lighthouse Score: 95+ (Accessibility & SEO)
- Code Quality: Full type hints, modular structure, 100% test passing.
- Security: Strict CSP, GZip enabled, Rate limited.
Developed with ❤️ for the Build with AI Challenge.