How codewithrakshit/parakh-ai works
Parakh AI audits packaged-product labels: a user submits label images, the backend extracts text and declarations, evaluates applicable rules, and returns an explainable score and report. The frontend also supports history, demo cases, authentication/workspaces, enforcement, and external verification capabilities. The analysis service’s dependency list identifies its principal collaborators; several route and UI implementations were not sampled, so their internal behavior is represented only where documented or indexed.
Main entry points: analysis_service.py Analysis orchestration · main.py FastAPI application · engine.py Compliance evaluation · App.tsx Web application
Components 27
User application
- Web application
frontend/src/App.tsx - Label analysis UI
frontend/src/pages/Analyze.tsx - Inspection history
frontend/src/pages/History.tsx - Results dashboard
frontend/src/pages/Results.tsx - API client
frontend/src/services/api.ts
API and identity
- FastAPI application
backend/main.py - Analysis endpoints
backend/api/analyze.py - Authentication and accounts
backend/auth/routes.py
Label analysis
- Analysis orchestration
backend/services/analysis_service.py - OCR engines
backend/ocr/paddle_engine.py - Declaration extraction
backend/extraction/extractor.py - Analysis data models
backend/models/schemas.py
Compliance evaluation
- Compliance endpoints
backend/api/compliance_routes.py - Compliance evaluation
backend/compliance/engine.py - Rule registry
backend/compliance/rules/registry.py - Legal metrology rules
backend/compliance/rules/legal_metrology.py - FSSAI rules
backend/compliance/rules/fssai.py - Recommendations
backend/compliance/recommendations.py
Persistence and integrations
- SQLite data store
backend/database/db.py - Report endpoints
backend/api/report.py - Audit report generation
backend/services/report_service.py - Integration endpoints
backend/api/integrations.py - FSSAI verification
backend/integrations/fssai/verifier.py - GS1 verification
backend/integrations/gs1/verifier.py - Enforcement endpoints
backend/api/enforcement.py - Penalty reference
backend/enforcement/penalties.py
Other components
- Inspector or merchant
Connections 36
- Inspector or merchant → Web application: uses
- Web application → Label analysis UI: routes to
frontend/src/App.tsx - Web application → Inspection history: routes to
frontend/src/App.tsx - Web application → Results dashboard: routes to
frontend/src/App.tsx - Label analysis UI → API client: submits analysis
- API client → FastAPI application: calls REST API
- FastAPI application → Analysis endpoints: registers
backend/main.py - FastAPI application → Compliance endpoints: registers
backend/main.py - FastAPI application → Authentication and accounts: registers
backend/main.py - FastAPI application → Report endpoints: registers
backend/main.py - FastAPI application → Integration endpoints: registers
backend/main.py - FastAPI application → Enforcement endpoints: registers
backend/main.py - Analysis endpoints → Analysis orchestration: dispatches analysis
- Analysis orchestration → OCR engines: selects engine
backend/services/analysis_service.py - Analysis orchestration → Declaration extraction: extracts declarations
backend/services/analysis_service.py - Analysis orchestration → Compliance evaluation: evaluates compliance
backend/services/analysis_service.py - Analysis orchestration → SQLite data store: persists analysis
backend/services/analysis_service.py - Analysis orchestration → FSSAI verification: requests verification
backend/services/analysis_service.py - Analysis orchestration → GS1 verification: requests verification
backend/services/analysis_service.py - Analysis orchestration → Analysis data models: uses schemas
backend/services/analysis_service.py - Compliance endpoints → Compliance evaluation: checks product
backend/api/compliance_routes.py - Compliance endpoints → Rule registry: lists rules
backend/api/compliance_routes.py - Compliance evaluation → Rule registry: loads rules
backend/compliance/engine.py - Rule registry → Legal metrology rules: registers evaluators
backend/compliance/rules/registry.py - Rule registry → FSSAI rules: registers evaluators
backend/compliance/rules/registry.py - Compliance evaluation → Legal metrology rules: evaluates rules
backend/compliance/engine.py - Compliance evaluation → FSSAI rules: evaluates rules
backend/compliance/engine.py - Compliance evaluation → Recommendations: builds recommendations
backend/compliance/engine.py - Report endpoints → Audit report generation: generates report
backend/api/report.py - Report endpoints → SQLite data store: reads audit data
backend/api/report.py - Report endpoints → Recommendations: uses findings
backend/api/report.py - Authentication and accounts → SQLite data store: manages accounts
backend/auth/routes.py - Authentication and accounts → SQLite data store: uses security data
backend/auth/routes.py - Integration endpoints → FSSAI verification: exposes verification
- Integration endpoints → GS1 verification: exposes verification
- Enforcement endpoints → Penalty reference: uses penalty data