How prajeeth-12/project-08 works
This is the backend and React client for an AI mock-interview platform. A candidate starts an interview in the browser; the backend streams speech through a voice engine, maintains interview context, and can produce post-turn coaching and a final scorecard. The README documents Nova Sonic streaming, interruption handling, renewal, and fallback voice operation. Resume analysis, coding exercises, code review, authentication, and session persistence are distinct supporting capabilities. Several domain links are inferred from the tree and documented architecture rather than sampled call sites, so those edges are marked unverified.
Main entry points: main.py FastAPI application · speech_api.py Speech WebSocket · session_manager.py Agent session manager · sessions.py Session endpoints
Components 26
API and sessions
- FastAPI application
backend/main.py - Authentication
backend/api/auth_api.py - Session endpoints
backend/api/sessions.py - Speech WebSocket
backend/api/speech_api.py - Agent endpoints
backend/api/agent_api.py
Interview agents
- Agent session manager
backend/services/session_manager.py - Interviewer agent
backend/agents/interviewer.py - Coach agent
backend/agents/agentic_coach.py - Agent orchestrator
backend/agents/orchestrator.py
Voice streaming
- Nova Sonic engine
backend/services/nova_sonic_engine.py - Gemini voice engine
backend/services/gemini_voice_engine.py - Nova Sonic worker
backend/services/nova_sonic_worker.py - Speech recognition
backend/api/speech/stt_service.py - Speech synthesis
backend/api/speech/tts_service.py
Assessment services
- Resume processing
backend/api/resumes.py - Interview evaluation
backend/api/evaluations.py - Code execution
backend/api/code_execution_api.py - Code review
backend/api/code_review.py - LLM service
backend/services/llm_service.py
Persistence
- Platform database
backend/database.py - Supabase manager
backend/database/db_manager.py
Other components
- Candidate browser
- Amazon Bedrock
- Google Gemini
- Supabase
- Judge0 sandbox
Connections 25
- Candidate browser → FastAPI application: uses
- FastAPI application → Authentication: routes
backend/main.py - FastAPI application → Session endpoints: routes
backend/main.py - FastAPI application → Speech WebSocket: routes
backend/main.py - FastAPI application → Agent endpoints: routes
backend/main.py - Speech WebSocket → Agent session manager: delegates
- Agent session manager → Interviewer agent: coordinates
- Agent session manager → Coach agent: evaluates turns
- Interviewer agent → LLM service: generates prompts
- Coach agent → LLM service: generates feedback
- Speech WebSocket → Nova Sonic engine: streams audio
- Speech WebSocket → Gemini voice engine: selects provider
- Nova Sonic engine → Amazon Bedrock: duplex stream
- Gemini voice engine → Google Gemini: live session
backend/services/gemini_voice_engine.py - Speech WebSocket → Speech recognition: uses
- Speech WebSocket → Speech synthesis: uses
- FastAPI application → Resume processing: routes
backend/main.py - FastAPI application → Interview evaluation: routes
backend/main.py - FastAPI application → Code execution: routes
backend/main.py - FastAPI application → Code review: routes
backend/main.py - Session endpoints → Platform database: persists sessions
- Supabase manager → Supabase: reads and writes
backend/database/db_manager.py - FastAPI application → Supabase manager: initializes
- Code execution → Judge0 sandbox: submits code
- Interview evaluation → Platform database: stores results