How siddhantsinghrao/build-with-agora works
StudyCircle’s primary workflow is a student joining a spoken tutoring session while a teacher observes live per-student comprehension reports. The repository also contains a separate Next.js voice tutor/counsellor implementation and an older static client with outbound calling. The main backend excerpt shows token issuance, Agora agent control, LLM proxying, report extraction, and telephony configuration; the documented README clarifies the primary UI/API workflow. Several UI and alternate-app relationships are not excerpted, so those links are omitted rather than inferred.
Main entry points: server.js Session API · agora.ts Agora Client Logic · TeacherDashboard.tsx Teacher Dashboard · route.ts Start Agent Route
Components 27
StudyCircle Main
- Student Console
web/components/StudentConsole.tsx - Teacher Dashboard
web/components/TeacherDashboard.tsx - Learning Cards
web/components/LeadCard.tsx - Web API Client
web/lib/api.ts
Session Backend
- Session API
server/server.js - RTC Tokens
server/server.js - Agent Control
server/server.js - Transcript Capture
server/server.js - Learning Reports
server/server.js - Outbound Calls
server/server.js - Telephony Config
server/server.js
Next Voice App
- Voice Session
voice-app-next/components/VoiceSession.tsx - Start Agent Route
voice-app-next/app/api/agent/start/route.ts - Stop Agent Route
voice-app-next/app/api/agent/stop/route.ts - Agent Status Route
voice-app-next/app/api/agent/status/[id]/route.ts - Token Route
voice-app-next/app/api/token/route.ts - Sessions Route
voice-app-next/app/api/sessions/route.ts - Session Dashboard
voice-app-next/app/dashboard/page.tsx - Agora Client Logic
voice-app-next/lib/agora.ts - Session Store
voice-app-next/lib/sessions.ts
Legacy Calling
- Counsellor UI
client/talk.html
Other components
- Student
- Teacher
- Agora Services
- LLM Service
- Vobiz
- Student Phone
Connections 28
- Student → Student Console: uses
README.md - Student Console → Session API: calls session APIs
README.md - Teacher → Teacher Dashboard: views reports
README.md - Teacher Dashboard → Session API: loads live data
README.md - Teacher Dashboard → Learning Cards: shows student cards
README.md - Session API → RTC Tokens: issues tokens
server/server.js - Session API → Agent Control: starts and stops
server/server.js - Agent Control → Agora Services: controls agents
server/server.js - Session API → Transcript Capture: captures turns
server/server.js - Transcript Capture → LLM Service: forwards prompts
server/server.js - Session API → Learning Reports: extracts reports
server/server.js - Learning Reports → LLM Service: requests extraction
server/server.js - Session API → Outbound Calls: starts calls
README.md - Outbound Calls → Agora Services: uses SIP gateway
README.md - Outbound Calls → Vobiz: checks credentials
server/server.js - Counsellor UI → Session API: configures calling
README.md - Counsellor UI → Student Phone: calls
README.md - Voice Session → Start Agent Route: starts agent
voice-app-next/components/VoiceSession.tsx - Voice Session → Stop Agent Route: stops agent
voice-app-next/components/VoiceSession.tsx - Start Agent Route → Agora Client Logic: starts agent
voice-app-next/app/api/agent/start/route.ts - Start Agent Route → Session Store: adds session
voice-app-next/app/api/agent/start/route.ts - Stop Agent Route → Agora Client Logic: stops agent
voice-app-next/app/api/agent/stop/route.ts - Stop Agent Route → Session Store: removes session
voice-app-next/app/api/agent/stop/route.ts - Agent Status Route → Agora Client Logic: queries agent
voice-app-next/app/api/agent/status/[id]/route.ts - Token Route → Agora Client Logic: mints token
voice-app-next/app/api/token/route.ts - Sessions Route → Session Store: lists sessions
voice-app-next/app/api/sessions/route.ts - Session Dashboard → Sessions Route: reads sessions
- Telephony Config → Vobiz: tests credentials
server/server.js