How ashwarygupta/vidyai works
VidyAI serves exam aspirants through a student portal and exposes the same learning capabilities to partners through an MCP API and partner-management portal. The student workflow spans doubt solving, revision, planning, practice tests, progress, syllabus and learning content; video processing also runs asynchronously. The README documents these capabilities, while sampled source confirms the API’s router registration, some retention and content-processing behavior, and partner-client requests. Several service-to-router details and integrations are documented but unsampled, so uncertain internal wiring is omitted.
Main entry points: main.py FastAPI gateway · client.ts Web API client · services Learning services · mcp.py MCP tools
Components 28
Student learning
- Student portal
apps/web/app/(dashboard)/dashboard - Web API client
apps/web/lib/api/client.ts - AI tutor
apps/web/app/(dashboard)/dashboard/tutor/page.tsx - Revision
apps/web/app/(dashboard)/dashboard/revision/page.tsx - Study planner
apps/web/app/(dashboard)/dashboard/planner/page.tsx - Study content
apps/web/app/(dashboard)/dashboard/content/page.tsx - Progress
apps/web/app/(dashboard)/dashboard/progress/page.tsx
Partner access
- Partner portal
apps/partner/app/(portal) - Partner API client
apps/partner/lib/api/partner-client.ts - Embed SDK
packages/embed-sdk/src/index.ts
API features
- FastAPI gateway
services/api/main.py - Tutor endpoint
services/api/routers/tutor.py - Retention endpoint
services/api/routers/retention.py - Planner endpoint
services/api/routers/planner.py - Test endpoints
services/api/routers/mcq.py - Content endpoint
services/api/routers/content.py - Progress endpoint
services/api/routers/progress.py - Knowledge endpoint
services/api/routers/knowledge.py - Syllabus endpoint
services/api/routers/syllabus.py - MCP tools
services/api/routers/mcp.py - Learning services
services/api/services - PageIndex search
services/api/services/knowledge_service.py
Async processing
- Video worker
services/api/workers/video_worker.py - Revision scheduler
services/api/workers/scheduler_worker.py
Persistence
- Supabase
Other components
- Student
- Partner operator
- Partner LLM agent
Connections 32
- Student → Student portal: uses
- Student portal → Web API client: requests features
- AI tutor → Web API client: calls API
- Revision → Web API client: calls API
- Study planner → Web API client: calls API
- Study content → Web API client: calls API
- Progress → Web API client: calls API
- Web API client → FastAPI gateway: HTTP requests
- FastAPI gateway → Tutor endpoint: mounts route
- FastAPI gateway → Retention endpoint: mounts route
- FastAPI gateway → Planner endpoint: mounts route
- FastAPI gateway → Test endpoints: mounts route
- FastAPI gateway → Content endpoint: mounts route
- FastAPI gateway → Progress endpoint: mounts route
- FastAPI gateway → Knowledge endpoint: mounts route
- FastAPI gateway → Syllabus endpoint: mounts route
- FastAPI gateway → MCP tools: mounts route
- Tutor endpoint → PageIndex search: retrieves context
- MCP tools → Learning services: delegates features
- Partner operator → Partner portal: manages account
- Partner portal → Partner API client: uses
- Partner API client → FastAPI gateway: partner requests
- Partner LLM agent → MCP tools: calls tools
- Embed SDK → FastAPI gateway: requests embedded features
- Retention endpoint → Learning services: handles retention
- Planner endpoint → Learning services: handles planning
- Test endpoints → Learning services: handles tests
- Content endpoint → Learning services: handles content
- Video worker → Supabase: updates video records
- Revision scheduler → Supabase: schedules revision cards
- PageIndex search → Supabase: reads and stores indexes
- Learning services → Supabase: persists learning state