# itsbk13/ai-interview-copilot-repo architecture

> Architecture diagram of the GitHub repository itsbk13/ai-interview-copilot-repo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itsbk13/ai-interview-copilot-repo
- Repository: https://github.com/itsbk13/ai-interview-copilot-repo

## Overview

Interview Copilot is a Streamlit recruiting tool for loading candidates, conducting AI-assisted interviews, and reviewing candidate records. The main workflow routes an interviewer from candidate setup into an interview workspace, where an LLM can request registered MCP tools; those tools read and update candidate data. Separate pages support resume uploads and candidate search. The graph includes all indexed core modules. Some page-to-tool links rely on the SOURCE INDEX’s import references; unsampled behavior is not inferred beyond those references.

Main entry points: [`app.py`](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/app.py) (Page Router), [`database/models.py`](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/models.py) (Data Models), [`server/mcp_server.py`](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/server/mcp_server.py) (MCP Tool Server), [`frontend/pages/interview_workspace.py`](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/interview_workspace.py) (Interview Workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Interview UI"]
  node_app["Page Router<br/>[app.py]"]
  node_sidebar["Navigation Sidebar<br/>[sidebar.py]"]
  node_home["Home Dashboard<br/>[home.py]"]
  node_newinterview["New Interview<br/>[new_interview.py]"]
  node_workspace["Interview Workspace"]
  node_candidatepage["Candidate Browser<br/>[candidate_db.py]"]
  node_upload["Resume Upload<br/>[upload_resume.py]"]
  node_uicomponents["UI Components<br/>[ui_components.py]"]
end

subgraph group_interview["Interview Services"]
  node_llmclient["LLM Tool Agent<br/>[llm_client.py]"]
  node_mcp["MCP Tool Server<br/>[mcp_server.py]"]
  node_resume["Resume Processing<br/>[resume_tools.py]"]
end

subgraph group_records["Candidate Records"]
  node_readtools["Candidate Reads<br/>[read_tools.py]"]
  node_querytools["Candidate Search<br/>[query_tools.py]"]
  node_writetools["Interview Writes<br/>[write_tools.py]"]
end

subgraph group_storage["Data Storage"]
  node_seed["Seed Data<br/>[seed_data.py]"]
  node_models["Data Models<br/>[models.py]"]
  node_db[("SQLite Database")]
  node_resumefiles["Resume PDFs"]
end

node_interviewer(("Interviewer"))
node_groq["Groq API"]

node_interviewer -->|"opens"| node_app
node_app -->|"renders"| node_sidebar
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_newinterview
node_app -->|"routes to"| node_candidatepage
node_app -->|"routes to"| node_upload
node_app -->|"routes to"| node_workspace
node_newinterview -.->|"starts interview"| node_workspace
node_newinterview -->|"uses"| node_resume
node_newinterview -->|"renders with"| node_uicomponents
node_workspace -->|"requests agent"| node_llmclient
node_workspace -->|"gets questions"| node_readtools
node_workspace -->|"saves results"| node_writetools
node_workspace -->|"renders with"| node_uicomponents
node_home -->|"reads records"| node_readtools
node_candidatepage -->|"loads candidates"| node_readtools
node_candidatepage -->|"filters candidates"| node_querytools
node_candidatepage -->|"renders with"| node_uicomponents
node_upload -->|"writes PDF"| node_resumefiles
node_llmclient -->|"discovers and executes"| node_mcp
node_llmclient -->|"sends tool requests"| node_groq
node_mcp -->|"registers tools"| node_resume
node_mcp -->|"registers tools"| node_readtools
node_mcp -->|"registers tools"| node_querytools
node_mcp -->|"registers tools"| node_writetools
node_mcp -->|"initializes database"| node_models
node_resume -->|"reads and writes"| node_models
node_resume -->|"loads PDF"| node_resumefiles
node_readtools -->|"queries"| node_models
node_querytools -->|"queries"| node_models
node_writetools -->|"updates"| node_models
node_models -->|"persists records"| node_db
node_seed -->|"uses models"| node_models

click node_app "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/app.py"
click node_sidebar "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/components/sidebar.py"
click node_home "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/home.py"
click node_newinterview "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/new_interview.py"
click node_workspace "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/interview_workspace.py"
click node_candidatepage "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/candidate_db.py"
click node_upload "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/upload_resume.py"
click node_uicomponents "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/components/ui_components.py"
click node_llmclient "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/llm_client.py"
click node_mcp "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/server/mcp_server.py"
click node_resume "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/resume_tools.py"
click node_readtools "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/read_tools.py"
click node_querytools "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/query_tools.py"
click node_writetools "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/write_tools.py"
click node_seed "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/seed_data.py"
click node_models "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/models.py"
click node_db "https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/interview_copilot.db"
click node_resumefiles "https://github.com/itsbk13/ai-interview-copilot-repo/tree/master/resumes"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_sidebar,node_home,node_newinterview,node_workspace,node_candidatepage,node_upload,node_uicomponents,node_interviewer toneBlue
class node_llmclient,node_mcp,node_resume toneAmber
class node_readtools,node_querytools,node_writetools,node_groq toneMint
class node_seed,node_models,node_db,node_resumefiles toneRose
```

## Components

### Interview UI

- [Page Router](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/app.py): `app.py`
- [Navigation Sidebar](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/components/sidebar.py): `frontend/components/sidebar.py`
- [Home Dashboard](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/home.py): `frontend/pages/home.py`
- [New Interview](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/new_interview.py): `frontend/pages/new_interview.py`
- [Interview Workspace](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/interview_workspace.py): `frontend/pages/interview_workspace.py`
- [Candidate Browser](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/candidate_db.py): `frontend/pages/candidate_db.py`
- [Resume Upload](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/pages/upload_resume.py): `frontend/pages/upload_resume.py`
- [UI Components](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/components/ui_components.py): `frontend/components/ui_components.py`

### Interview Services

- [LLM Tool Agent](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/frontend/llm_client.py): `frontend/llm_client.py`
- [MCP Tool Server](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/server/mcp_server.py): `server/mcp_server.py`
- [Resume Processing](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/resume_tools.py): `tools/resume_tools.py`

### Candidate Records

- [Candidate Reads](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/read_tools.py): `tools/read_tools.py`
- [Candidate Search](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/query_tools.py): `tools/query_tools.py`
- [Interview Writes](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/tools/write_tools.py): `tools/write_tools.py`

### Data Storage

- [Seed Data](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/seed_data.py): `database/seed_data.py`
- [Data Models](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/models.py): `database/models.py`
- [SQLite Database](https://github.com/itsbk13/ai-interview-copilot-repo/blob/master/database/interview_copilot.db): `database/interview_copilot.db`
- [Resume PDFs](https://github.com/itsbk13/ai-interview-copilot-repo/tree/master/resumes): `resumes`

### Other components

- **Interviewer**
- **Groq API**

## Connections

- Interviewer → Page Router: opens (evidence: `app.py`)
- Page Router → Navigation Sidebar: renders (evidence: `app.py`)
- Page Router → Home Dashboard: routes to (evidence: `app.py`)
- Page Router → New Interview: routes to (evidence: `app.py`)
- Page Router → Candidate Browser: routes to (evidence: `app.py`)
- Page Router → Resume Upload: routes to (evidence: `app.py`)
- Page Router → Interview Workspace: routes to (evidence: `app.py`)
- New Interview → Interview Workspace: starts interview
- New Interview → Resume Processing: uses (evidence: `frontend/pages/new_interview.py`)
- New Interview → UI Components: renders with (evidence: `frontend/pages/new_interview.py`)
- Interview Workspace → LLM Tool Agent: requests agent (evidence: `frontend/pages/interview_workspace.py`)
- Interview Workspace → Candidate Reads: gets questions (evidence: `frontend/pages/interview_workspace.py`)
- Interview Workspace → Interview Writes: saves results (evidence: `frontend/pages/interview_workspace.py`)
- Interview Workspace → UI Components: renders with (evidence: `frontend/pages/interview_workspace.py`)
- Home Dashboard → Candidate Reads: reads records (evidence: `frontend/pages/home.py`)
- Candidate Browser → Candidate Reads: loads candidates (evidence: `frontend/pages/candidate_db.py`)
- Candidate Browser → Candidate Search: filters candidates (evidence: `frontend/pages/candidate_db.py`)
- Candidate Browser → UI Components: renders with (evidence: `frontend/pages/candidate_db.py`)
- Resume Upload → Resume PDFs: writes PDF (evidence: `frontend/pages/upload_resume.py`)
- LLM Tool Agent → MCP Tool Server: discovers and executes (evidence: `frontend/llm_client.py`)
- LLM Tool Agent → Groq API: sends tool requests (evidence: `frontend/llm_client.py`)
- MCP Tool Server → Resume Processing: registers tools (evidence: `server/mcp_server.py`)
- MCP Tool Server → Candidate Reads: registers tools (evidence: `server/mcp_server.py`)
- MCP Tool Server → Candidate Search: registers tools (evidence: `server/mcp_server.py`)
- MCP Tool Server → Interview Writes: registers tools (evidence: `server/mcp_server.py`)
- MCP Tool Server → Data Models: initializes database (evidence: `server/mcp_server.py`)
- Resume Processing → Data Models: reads and writes (evidence: `tools/resume_tools.py`)
- Resume Processing → Resume PDFs: loads PDF (evidence: `tools/resume_tools.py`)
- Candidate Reads → Data Models: queries (evidence: `tools/read_tools.py`)
- Candidate Search → Data Models: queries (evidence: `tools/query_tools.py`)
- Interview Writes → Data Models: updates (evidence: `tools/write_tools.py`)
- Data Models → SQLite Database: persists records (evidence: `database/models.py`)
- Seed Data → Data Models: uses models (evidence: `database/seed_data.py`)
