How sidsahoo1203/bharatassist works
BharatAssist helps citizens explore schemes, assess eligibility, ask questions by voice, visualize comparisons, and prepare application forms. The main user journey runs from onboarding/profile input through scheme matching to results and follow-on scheme, voice, visual, or PDF-form tools. The backend also moderates voice responses with trained safety and language models. The repository includes a separate ML development package for preparing data, training and evaluating classifiers. Frontend route-to-engine and frontend-to-backend wiring is not established by the excerpts, so those links are omitted.
Main entry points: config.py ML configuration · exceptions.py ML exceptions · models.py Text classifiers · scraper.py Scheme scraper
Components 23
Citizen experience
- Profile onboarding
frontend/src/app/onboard/page.tsx - Eligibility dashboard
frontend/src/app/dashboard/page.tsx - Scheme browser
frontend/src/app/schemes/page.tsx - Voice assistant
frontend/src/app/voice/page.tsx - Visual comparisons
frontend/src/app/visual/page.tsx - Form preparation
frontend/src/app/form/page.tsx - Demo comparisons
frontend/src/app/demo-comparisons/page.tsx
Scheme services
- Eligibility engine
frontend/src/lib/eligibilityEngine.ts - Scheme catalogue
frontend/src/lib/schemes.ts - FastAPI services
backend/main.py - Scheme records
backend/data/schemes.json
Voice and safety
- Safety guard
backend/safety_guard.py
ML development
- Text classifiers
ml/src/bharatassist/models.py - Text preprocessing
ml/src/bharatassist/preprocessing.py - Scheme safety examples
ml/src/bharatassist/domain_data.py - Deep models
ml/src/bharatassist/deep.py - Model evaluation
ml/src/bharatassist/evaluation.py - Dataset loading
ml/src/bharatassist/data_loader.py - ML configuration
ml/src/bharatassist/config.py - ML exceptions
ml/src/bharatassist/exceptions.py - ML logging
ml/src/bharatassist/logger.py - Scheme scraper
ml/src/bharatassist/scraper.py
Other components
- Citizen
Connections 21
- Citizen → Profile onboarding: provides profile
README.md - Citizen → Voice assistant: asks by voice
README.md - Citizen → Scheme browser: browses schemes
README.md - Citizen → Visual comparisons: views charts
README.md - Citizen → Form preparation: prepares form
README.md - Eligibility engine → Scheme catalogue: reads catalogue
frontend/src/lib/eligibilityEngine.ts - FastAPI services → Safety guard: checks messages
backend/main.py - Safety guard → Text classifiers: loads and scores
backend/safety_guard.py - Safety guard → Text preprocessing: cleans text
backend/safety_guard.py - ML configuration → ML exceptions: referenced by
ml/src/bharatassist/data_loader.py - Dataset loading → ML configuration: uses paths
ml/src/bharatassist/data_loader.py - Dataset loading → ML exceptions: raises errors
ml/src/bharatassist/data_loader.py - Text preprocessing → ML configuration: uses mappings
ml/src/bharatassist/preprocessing.py - Text preprocessing → ML exceptions: raises errors
ml/src/bharatassist/preprocessing.py - Text classifiers → ML configuration: uses settings
ml/src/bharatassist/models.py - Text classifiers → ML exceptions: uses exceptions
ml/src/bharatassist/models.py - Deep models → Text classifiers: extends classifiers
ml/src/bharatassist/deep.py - Scheme safety examples → ML configuration: uses paths
ml/src/bharatassist/domain_data.py - Scheme scraper → ML configuration: uses paths
ml/src/bharatassist/scraper.py - Scheme scraper → ML exceptions: uses exceptions
ml/src/bharatassist/scraper.py - Scheme scraper → ML logging: uses logging
ml/src/bharatassist/scraper.py