🌿 Zen Citizen AI

AI-Powered Government Guidance Assistant with Multi-Source Verification

Get instant, verified guidance on Indian government services. Zen Citizen AI combines internal databases, official government websites, verified sources, community forums, and ChatGPT synthesis to provide reliable information with confidence scores.

✨ Features

🎯 Core Functionality

Multi-Source Verification: Fetches data from 5+ sources simultaneously
Confidence Scoring: Shows reliability of each answer (High/Medium/Low)
AI Synthesis: ChatGPT verifies and synthesizes information
State Awareness: Get guidance specific to your state
Beautiful Interface: Modern, responsive design

🔄 Data Sources

Internal Database (95% confidence) - Pre-verified guides
Official Government Sites (85% confidence) - .gov.in domains
Verified Websites (75% confidence) - Trusted organizations
Community Forums (40-60% confidence) - Reddit & YouTube
AI Verification (Variable) - ChatGPT synthesis

🛠️ Technologies

Backend: Node.js, Express, MongoDB
Frontend: HTML5, CSS3, Vanilla JavaScript
AI: OpenAI GPT-4o-mini
Data: Axios, Cheerio, MongoDB
Deployment: Ready for Heroku, Railway, Vercel, etc.

🚀 Quick Start

Prerequisites

Node.js 14+
MongoDB (local or Atlas)
Python 3 (for frontend development)
OpenAI API key

1. Backend Setup

cd Zencitizen-backend

# Install dependencies
npm install

# Create .env file
cp .env.example .env
# Edit .env and add your OpenAI API key and MongoDB URI

# Start server
npm start

Backend runs on http://localhost:8000

2. Frontend Setup

cd Zencitizen-frontend

# Start HTTP server
python3 -m http.server 8888

Frontend accessible at http://localhost:8888

3. Test Integration

Visit http://localhost:8888 and ask:

"How do I apply for passport?"
"Voter ID requirements in Maharashtra?"
"Driving license process"

📁 Project Structure

Zencitizen-AI/
├── Zencitizen-backend/          # Backend API
│   ├── server.js                # Main server
│   ├── models/Guide.js          # MongoDB schema
│   ├── services/
│   │   ├── guidanceEngine.js    # Core orchestrator
│   │   ├── serviceRegistry.js   # Service definitions
│   │   ├── confidenceScorer.js  # Scoring system
│   │   ├── chatgptSynthesis.js  # AI synthesis
│   │   ├── mcpSources.js        # Reddit/YouTube
│   │   └── verifiedWebsites.js  # Official sources
│   ├── config/services.js       # Service mappings
│   ├── package.json
│   ├── .env.example
│   ├── SETUP_GUIDE.md
│   └── README.md
│
├── Zencitizen-frontend/         # Frontend UI
│   ├── index.html
│   ├── css/
│   │   ├── styles.css
│   │   └── components.css
│   ├── js/main.js
│   ├── README.md
│   ├── QUICK_START.md
│   ├── ARCHITECTURE.md
│   └── .gitignore
│
├── README.md                     # This file
├── LICENSE
└── .gitignore

🎯 Available Services

Indian Passport - Travel documents
Voter ID - Electoral card
Driving License - Vehicle license
Aadhaar - National ID
PAN Card - Tax identification
Ration Card - Food security
Property Registration - Land registry

📊 How It Works

Request Flow

User Question
    ↓
Service Identification (Search Registry)
    ↓
Internal Database Check (MongoDB)
    ↓
Official Sites Fetch (.gov.in domains) ├─ Parallel
Community Sources (Reddit/YouTube)      │
Verified Websites                       ↓
    ↓
Confidence Scoring & AI Synthesis (ChatGPT)
    ↓
Structured JSON Response
    ↓
Beautiful Results Display

Confidence Levels

High (85-100%): Internal DB or official government
Medium (60-84%): Verified sources with some consensus
Low (1-59%): Community-only sources, verify directly

🔌 API Endpoints

POST /api/chat

Get guidance on any government service.

Request:

{
  "question": "How do I apply for passport?",
  "state": "Maharashtra"
}

Response:

{
  "source": "hybrid+verified_websites+community",
  "confidenceLevel": "High",
  "service": "Indian Passport",
  "state": "Maharashtra",
  "answer": "...",
  "steps": [...],
  "requiredDocuments": [...],
  "fees": "₹1500",
  "processingTime": "7-14 days",
  "eligibility": "...",
  "officialLinks": [...],
  "confidenceScore": 0.95
}

POST /api/add-guide

Add a new guide (admin).

POST /api/fetch-raw

Fetch raw content from URL.

POST /api/structure-content

Structure raw content with ChatGPT.

DELETE /api/delete-guide/:category

Remove a guide.

🎨 Frontend Features

Hero Section - Eye-catching landing page
Service Browser - Browse 7+ government services
Chat Interface - Real-time guidance
Results Modal - Detailed information display
Source Tracking - View all sources used
Search History - Recent searches saved locally
Responsive Design - Works on all devices

📱 Browser Support

Chrome 90+
Firefox 88+
Safari 14+
Edge 90+
Mobile browsers

🔒 Security & Privacy

No personal data collection
All API keys stored server-side (.env)
Source domain verification
Community sources weighted lower
External page verification
CORS enabled for safety

📚 Documentation

🚀 Deployment

Frontend

Netlify: netlify deploy --prod
Vercel: vercel --prod
GitHub Pages: Push to gh-pages branch
AWS S3: aws s3 sync . s3://bucket

Backend

Heroku: git push heroku main
Railway: railway up
Render: Connect GitHub repo
AWS EC2, DigitalOcean, or custom VPS

Environment Setup

Create .env file with secrets
Set MongoDB Atlas connection
Add OpenAI API key
Configure CORS for frontend domain

🧪 Testing

Test Backend

# Chat endpoint
curl -X POST http://localhost:8000/api/chat \
  -H "Content-Type: application/json" \
  -d '{"question":"How to get passport?"}'

# Add guide
curl -X POST http://localhost:8000/api/add-guide \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Test",
    "category": "passport",
    "overview": "Test",
    "sourceUrl": "https://test.gov.in"
  }'

# View database
curl http://localhost:8000/debug-guides

Test Frontend

Open http://localhost:8888
Search different services
Check browser console (F12)
Test on mobile devices

🐛 Troubleshooting

Backend Issues

# Check MongoDB connection
# Verify OPENAI_API_KEY is set
# Check port 8000 is available
lsof -i :8000

# View logs
npm start

Frontend Issues

# Check port 8888 is available
lsof -i :8888

# Clear browser cache
# Check DevTools Network/Console tabs

API Connection

Verify both servers running
Check API base URL in frontend code
Inspect network requests
Review error messages in console

📈 Performance

Backend: 5-15s (includes synthesis)
Frontend: <100ms render
Database: <100ms queries
Bundle: ~50KB assets
Lightweight & optimized

💡 Future Enhancements

🤝 Contributing

We welcome contributions!

Fork the repository
Create feature branch (git checkout -b feature/amazing)
Commit changes (git commit -am 'Add amazing feature')
Push to branch (git push origin feature/amazing)
Open Pull Request

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

Built with Node.js, Express, MongoDB
AI powered by OpenAI
Community data from Reddit & YouTube
Government data from official sources

📞 Support & Contact

Open issues for bugs
Discussions for feature requests
Email: support@zencitizen.ai (coming soon)

📊 Stats

🚀 7+ Government Services
🔗 5+ Data Sources
🧠 AI-Powered Verification
🎨 Modern Web Interface
⚡ Fast & Lightweight

🌿 Zen Citizen AI - Making Government Guidance Simple & Reliable

Built with ❤️ using modern web technologies. Designed to help Indians navigate government services effortlessly.

Last Updated: February 2026

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
backend		backend
frontend		frontend
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

License

pestechnology/Zencitizen

Folders and files

Latest commit

History

Repository files navigation