How mukesh631102/ai-interviewer works
Open Source AI Interviewer is a Flask/Socket.IO app for role-specific mock interviews. The workflow runs from browser role selection, through speech capture and a live AI question/answer exchange, to an evaluation report. The README also documents webcam preview and browser speech synthesis; those client capabilities are represented, though their templates were not sampled. The graph follows shown route and event handlers; no persistent store is present, and chat history is held in app memory.
Main entry points: app.py Socket Events · interview.js Live Interview · index.html Role Selection · main.js Start Session
Components 16
Browser Experience
- Role Selection
templates/index.html - Start Session
static/js/main.js - Interview Room
templates/interview.html - Live Interview
static/js/interview.js - Camera Preview
static/js/interview.js - Speech Capture
static/js/interview.js - Voice Responses
static/js/interview.js - Report Page
templates/report.html
Interview Server
- Page Routes
app.py - Socket Events
app.py - Session History
app.py
Interview Intelligence
- Transcript Cleanup
utils/audio_processor.py - Question Agent
utils/ai_agent.py - Report Evaluator
utils/evaluator.py
Other components
- Candidate
- Groq API
Connections 23
- Candidate → Role Selection: chooses role
README.md - Role Selection → Start Session: starts session
README.md - Start Session → Page Routes: navigates to
static/js/main.js - Candidate → Live Interview: answers aloud
README.md - Live Interview → Camera Preview: requests media
static/js/interview.js - Live Interview → Speech Capture: starts recognition
static/js/interview.js - Speech Capture → Socket Events: emits answer
static/js/interview.js - Socket Events → Transcript Cleanup: cleans transcript
app.py - Socket Events → Session History: appends turns
app.py - Socket Events → Question Agent: requests response
app.py - Question Agent → Groq API: requests completion
utils/ai_agent.py - Socket Events → Live Interview: emits question
app.py - Live Interview → Voice Responses: speaks response
static/js/interview.js - Candidate → Live Interview: ends interview
README.md - Live Interview → Socket Events: requests report
static/js/interview.js - Socket Events → Session History: reads transcript
app.py - Socket Events → Report Evaluator: generates report
app.py - Report Evaluator → Groq API: requests evaluation
utils/evaluator.py - Socket Events → Live Interview: returns report
app.py - Live Interview → Report Page: navigates to
static/js/interview.js - Page Routes → Role Selection: renders page
app.py - Page Routes → Interview Room: renders page
app.py - Page Routes → Report Page: renders page
app.py