How huanche/agentic-class-pilot works
Agentic Class Pilot is a three-service AI education platform. Users enter through the platform for unified login and role-based access, then build or publish courses as teachers or enroll and learn as students; trusted platform bridges provide service access and student launch context. The graph preserves the documented course-building, classroom, playback, and learning branches. Backend and student-agent links use sampled source references; teacher-agent internals were not sampled, so those capabilities are represented at their documented service boundary.
Main entry points: api Platform API · student_bridge.py Agent bridges · server.py Student service · app Teacher workspace
Components 23
Platform and identity
- Platform UI
platform/frontend/src - Platform API
platform/backend/app/api - Login and roles
platform/backend/app/api/routes/login.py - Agent bridges
platform/backend/app/api/routes/student_bridge.py - Course access
platform/backend/app/services/course_access.py - Platform records
platform/backend/app/models.py - Agent sessions
platform/backend/app/services/agent_sessions.py
Teacher experience
- Teacher workspace
teacher_agent/app - Course authoring
teacher_agent/components/course-space - Content generation
teacher_agent/app/api/generate - Course publishing
teacher_agent/app/api/course-space - Classroom and player
teacher_agent/app/classroom - Playback engine
teacher_agent/lib/playback/engine.ts
Student learning
- Student experience
student_agent/frontend/src - Student service
student_agent/apps/server.py - Platform integration
student_agent/apps/integration
Agent runtime
- Lesson orchestrator
student_agent/orchestrator/agent.py - Chat graph
platform/backend/app/core/langgraph/graph.py - Outline agent
platform/backend/app/core/langgraph/outline.py - Graph checkpoints
platform/backend/app/core/langgraph/checkpoint.py - LLM configuration
platform/backend/app/core/config.py
Other components
- Users
- PostgreSQL and object storage
Connections 28
- Users → Platform UI: use
README.md - Platform UI → Platform API: request
platform/frontend/src/main.tsx - Platform API → Login and roles: routes login
platform/backend/app/api/main.py - Platform API → Agent bridges: routes bridges
platform/backend/app/api/main.py - Login and roles → Platform records: read account
platform/backend/app/api/routes/login.py - Agent bridges → Course access: check access
platform/backend/app/api/routes/student_bridge.py - Agent bridges → Platform records: read records
platform/backend/app/api/routes/student_bridge.py - Agent bridges → Agent sessions: resolve sessions
- Platform API → Teacher workspace: trusted service access
README.md - Agent bridges → Student service: launch context
README.md - Teacher workspace → Course authoring: build courses
README.md - Course authoring → Content generation: generate materials
README.md - Course authoring → Course publishing: publish content
README.md - Teacher workspace → Classroom and player: teach classes
README.md - Classroom and player → Playback engine: run playback
- Users → Student experience: learn
README.md - Student experience → Student service: send turns
student_agent/frontend/src/legacy/app.js - Student service → Lesson orchestrator: delegate lessons
student_agent/apps/server.py - Student service → Platform integration: use platform adapters
student_agent/apps/server.py - Platform integration → Platform API: trusted requests
README.md - Platform API → Chat graph: embed agent runtime
platform/backend/app/main.py - Platform API → Outline agent: embed agent runtime
platform/backend/app/main.py - Chat graph → Graph checkpoints: persist state
platform/backend/app/core/langgraph/graph.py - Outline agent → Graph checkpoints: persist state
platform/backend/app/core/langgraph/outline.py - Chat graph → LLM configuration: configure model
platform/backend/app/core/langgraph/graph.py - Outline agent → LLM configuration: configure model
platform/backend/app/core/langgraph/outline.py - Course publishing → PostgreSQL and object storage: store course data
README.md - Student service → PostgreSQL and object storage: persist learning data
README.md