🗳️ Election Assistant
🚀 Simplifying the Voting Process with AI & Real-Time Data
🌍 Live Project
👉 https://utkarshya01.github.io/election-assistant/
📌 About the Project
Election Assistant is a smart, interactive web application that helps users understand and navigate the election process effortlessly.
From eligibility checks to locating polling stations and answering election-related queries using AI — this project aims to make civic participation simple, accessible, and engaging.
✨ Key Features
🔍 Eligibility Checker → Instantly understand if you can vote
📄 Required Documents Guide → Clear list of necessary documents
🗺️ Polling Location Finder → Locate nearest voting center using maps
🤖 AI Chat Assistant → Ask election-related questions naturally
⚡ Quick Suggestions → One-click answers for common queries
🧠 Tech Stack
Technology| Usage HTML, CSS, JS| Frontend UI Node.js| Backend logic OpenAI API| AI chatbot Google Civic API| Election data Google Maps API| Location services
🖥️ Project Structure
election-assistant/ │ ├── index.html ├── style.css ├── script.js ├── server.js ├── .env.template ├── .gitignore ├── package.json
⚙️ Setup Instructions
1️⃣ Clone Repository
git clone https://github.com/Utkarshya01/election-assistant.git cd election-assistant
2️⃣ Install Dependencies
npm install
3️⃣ Setup Environment Variables
Create a ".env" file and add:
OPENAI_API_KEY=your_key_here GOOGLE_CIVIC_API_KEY=your_key_here GOOGLE_MAPS_API_KEY=your_key_here
4️⃣ Run the App
node server.js
👉 GitHub Pages only hosts frontend 👉 Backend features (API calls) require server deployment
🔒 Security
✔ API keys are protected using ".env" ✔ ".env" is excluded via ".gitignore" ✔ No sensitive data exposed
📸 Preview
🚀 Future Enhancements
- 🌐 Deploy full-stack version (backend + frontend)
- 📱 Improve mobile responsiveness
- 🎨 Add animations & modern UI
- 🧠 Enhance AI accuracy
👨💻 Author
Utkarsh Yadav 🎓 Student | 💻 Developer | 🚀 Builder
⭐ Support
If you like this project: 👉 Give it a ⭐ on GitHub 👉 Share with others
Made with ❤️ by Utkarsh Yadav