How kaniska-praba007/nutrimind-ai works
NutriMind AI is an Indian-food nutrition tracker and assistant. Users can log or photograph meals, get deterministic nutrition totals, and use AI for meal plans, food swaps, recovery suggestions, and evidence-backed chat; analytics, grocery planning, and clinical safety are additional capabilities. The graph traces documented backend calls and app wiring. Several frontend feature pages and agent integrations are unsampled, so their connections are shown only where the README documents them or omitted when implementation links are uncertain.
Main entry points: main.py FastAPI application · supabase_client.py Supabase client · orchestrator.py Intent orchestration · meal_plan_agent.py Meal planning
Components 34
User experience
- Web application
frontend/src/App.tsx - Page routing
frontend/src/router.tsx - Food logging UI
frontend/src/pages/FoodLogPage.tsx - Chat UI
frontend/src/pages/ChatPage.tsx - Meal planner UI
frontend/src/pages/PlannerPage.tsx - Analytics UI
frontend/src/pages/DashboardPage.tsx - Safety tools
frontend/src/pages/SafetyAuditorPage.tsx
Nutrition tracking
- Food routes
backend/app/api/food.py - Food data and logs
backend/app/services/food_service.py - Nutrition calculations
backend/app/services/nutrition_engine.py - Analytics routes
backend/app/api/analytics.py - Profile routes
backend/app/api/users.py
AI assistance
- Meal routes
backend/app/api/meals.py - Meal planning
backend/app/agents/meal_plan_agent.py - Food swaps
backend/app/agents/swap_agent.py - Meal rescue
backend/app/agents/rescue_agent.py - Grocery routes
backend/app/api/grocery.py - Grocery planning
backend/app/agents/grocery_agent.py - Chat routes
backend/app/api/chat.py - Intent orchestration
backend/app/agents/orchestrator.py - Knowledge answers
backend/app/agents/knowledge_agent.py - Guideline retrieval
backend/app/rag/retriever.py - Answer context
backend/app/rag/context_builder.py - Plate recognition
backend/app/agents/food_recognition_agent.py - Feedback routes
backend/app/api/feedback.py - Feedback analysis
backend/app/agents/feedback_agent.py
Identity and data
- FastAPI application
backend/app/main.py - Token verification
backend/app/middleware/supabase_auth.py - Supabase client
backend/app/db/supabase_client.py - Supabase data store
- AI provider factory
backend/app/ai/factory.py - Groq provider
backend/app/ai/groq_provider.py - Google AI provider
backend/app/ai/google_provider.py
Other components
- User
Connections 41
- User → Web application: uses
- Web application → Page routing: mounts
frontend/src/App.tsx - FastAPI application → Food routes: registers
backend/app/main.py - FastAPI application → Meal routes: registers
backend/app/main.py - FastAPI application → Chat routes: registers
backend/app/main.py - FastAPI application → Profile routes: registers
backend/app/main.py - FastAPI application → Feedback routes: registers
backend/app/main.py - FastAPI application → Grocery routes: registers
backend/app/main.py - FastAPI application → Analytics routes: registers
backend/app/main.py - Food routes → Food data and logs: calls
backend/app/api/food.py - Food routes → Nutrition calculations: calculates with
backend/app/api/food.py - Food routes → Plate recognition: invokes
backend/app/api/food.py - Analytics routes → Supabase client: reads
backend/app/api/analytics.py - Analytics routes → Nutrition calculations: calculates with
backend/app/api/analytics.py - Analytics routes → Food data and logs: uses
backend/app/api/analytics.py - Profile routes → Supabase client: reads and writes
backend/app/api/users.py - Profile routes → Nutrition calculations: calculates with
backend/app/api/users.py - Meal routes → Meal planning: invokes
backend/app/api/meals.py - Meal routes → Food swaps: invokes
backend/app/api/meals.py - Meal routes → Meal rescue: invokes
backend/app/api/meals.py - Meal planning → Food data and logs: gets foods
backend/app/agents/meal_plan_agent.py - Meal planning → Nutrition calculations: calculates with
backend/app/agents/meal_plan_agent.py - Meal planning → Supabase client: reads and writes
backend/app/agents/meal_plan_agent.py - Grocery routes → Grocery planning: invokes
backend/app/api/grocery.py - Grocery routes → Supabase client: uses
backend/app/api/grocery.py - Chat routes → Intent orchestration: calls
backend/app/api/chat.py - Intent orchestration → Knowledge answers: routes queries
backend/app/agents/orchestrator.py - Intent orchestration → Meal planning: dispatches plans
backend/app/agents/orchestrator.py - Intent orchestration → Meal rescue: dispatches rescue
backend/app/agents/orchestrator.py - Intent orchestration → Answer context: builds personal context
backend/app/agents/orchestrator.py - Intent orchestration → Supabase client: reads personal data
backend/app/agents/orchestrator.py - Knowledge answers → Guideline retrieval: retrieves evidence
backend/app/agents/knowledge_agent.py - Knowledge answers → Answer context: builds answer context
backend/app/agents/knowledge_agent.py - Guideline retrieval → AI provider factory: embeds queries
backend/app/rag/retriever.py - Guideline retrieval → Supabase client: searches chunks
backend/app/rag/retriever.py - Feedback routes → Feedback analysis: invokes
backend/app/api/feedback.py - Food data and logs → Supabase client: reads and logs
backend/app/services/food_service.py - Supabase client → Supabase data store: queries
backend/app/db/supabase_client.py - Token verification → Supabase data store: verifies tokens
backend/app/middleware/supabase_auth.py - AI provider factory → Groq provider: generates text
backend/app/ai/factory.py - AI provider factory → Google AI provider: generates or embeds
backend/app/ai/factory.py