# siddhi472006/career_copilot architecture

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

- Interactive diagram: https://gitdiagram.com/siddhi472006/career_copilot
- Repository: https://github.com/siddhi472006/career_copilot

## Overview

AI Career Copilot takes a candidate from resume upload and job-description analysis to tailored career outputs, presented through a Streamlit dashboard and FastAPI service. Its coordinator parses and matches first, then runs several recommendation agents in parallel. The repository also documents job discovery, authentication, analysis history, recruiter/project features, and MCP access. Edges reflect sampled calls, SOURCE INDEX references, or README documentation; the frontend-to-API connection and some unsampled route wiring are not verified in the excerpts.

Main entry points: [`api/routes.py`](https://github.com/siddhi472006/career_copilot/blob/master/api/routes.py) (REST Routes), [`utils/llm_client.py`](https://github.com/siddhi472006/career_copilot/blob/master/utils/llm_client.py) (LLM Client), [`agents/coordinator.py`](https://github.com/siddhi472006/career_copilot/blob/master/agents/coordinator.py) (Analysis Coordinator), [`mcp_server.py`](https://github.com/siddhi472006/career_copilot/blob/master/mcp_server.py) (MCP Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_dashboard["Streamlit Dashboard<br/>[app.py]"]
end

subgraph group_api["Service and Access"]
  node_fastapi["FastAPI Application<br/>[main.py]"]
  node_routes["REST Routes<br/>[routes.py]"]
  node_mcp["MCP Server<br/>[mcp_server.py]"]
end

subgraph group_career["Career Agents"]
  node_parser["Resume Parser<br/>[pdf_parser.py]"]
  node_analyzer["Resume Analyzer<br/>[resume_analyzer.py]"]
  node_coordinator["Analysis Coordinator<br/>[coordinator.py]"]
  node_matcher["Job Matcher<br/>[job_matcher.py]"]
  node_ats["ATS Optimizer<br/>[ats_optimizer.py]"]
  node_roadmap["Learning Roadmap<br/>[roadmap_agent.py]"]
  node_interview["Mock Interview<br/>[mock_interview.py]"]
  node_cover["Cover Letter<br/>[cover_letter.py]"]
  node_salary["Salary Predictor"]
  node_recommend["Job Recommender<br/>[job_recommender.py]"]
  node_skillgap["Skill Gap Bridge"]
  node_reverse["Reverse Pitch"]
end

subgraph group_data["Identity and Data"]
  node_auth["Authentication<br/>[auth.py]"]
  node_otp["OTP Service<br/>[otp_service.py]"]
  node_models["Domain Models<br/>[models.py]"]
  node_db[("SQL Database<br/>[db.py]")]
end

subgraph group_integrations["AI and Integrations"]
  node_llm["LLM Client<br/>[llm_client.py]"]
  node_websearch["Salary Web Search"]
  node_jobplatforms["Job Platforms"]
  node_email["Email Service<br/>[email_service.py]"]
end

node_candidate(("Candidate"))

node_candidate -->|"uploads and views"| node_dashboard
node_dashboard -.->|"uses backend"| node_fastapi
node_fastapi -->|"registers routes"| node_routes
node_routes -->|"runs analysis"| node_coordinator
node_coordinator -->|"analyzes first"| node_analyzer
node_analyzer -->|"parses resume"| node_parser
node_coordinator -->|"calculates match"| node_matcher
node_coordinator -->|"runs in parallel"| node_ats
node_coordinator -->|"runs in parallel"| node_roadmap
node_coordinator -->|"runs in parallel"| node_interview
node_coordinator -->|"runs in parallel"| node_cover
node_coordinator -->|"runs in parallel"| node_salary
node_routes -->|"requests recommendations"| node_recommend
node_routes -->|"generates bridge"| node_skillgap
node_routes -->|"requests pitch"| node_reverse
node_mcp -->|"exposes analysis"| node_analyzer
node_mcp -->|"exposes matching"| node_matcher
node_mcp -->|"exposes optimization"| node_ats
node_mcp -->|"exposes roadmap"| node_roadmap
node_mcp -->|"exposes interview"| node_interview
node_mcp -->|"exposes letters"| node_cover
node_mcp -->|"exposes prediction"| node_salary
node_routes -->|"authenticates users"| node_auth
node_routes -->|"uses OTP flows"| node_otp
node_otp -->|"sends email"| node_email
node_routes -->|"queries records"| node_models
node_routes -->|"opens sessions"| node_db
node_db -->|"registers models"| node_models
node_analyzer -->|"asks LLM"| node_llm
node_matcher -->|"asks LLM"| node_llm
node_ats -->|"asks LLM"| node_llm
node_roadmap -->|"asks LLM"| node_llm
node_interview -->|"asks LLM"| node_llm
node_cover -->|"asks LLM"| node_llm
node_salary -->|"asks LLM"| node_llm
node_recommend -->|"uses LLM"| node_llm
node_skillgap -->|"uses LLM"| node_llm
node_reverse -->|"uses LLM"| node_llm
node_salary -->|"gathers context"| node_websearch
node_routes -.->|"fetches job listings"| node_jobplatforms
node_recommend -.->|"searches platforms"| node_jobplatforms

click node_dashboard "https://github.com/siddhi472006/career_copilot/blob/master/frontend/app.py"
click node_fastapi "https://github.com/siddhi472006/career_copilot/blob/master/api/main.py"
click node_routes "https://github.com/siddhi472006/career_copilot/blob/master/api/routes.py"
click node_mcp "https://github.com/siddhi472006/career_copilot/blob/master/mcp_server.py"
click node_parser "https://github.com/siddhi472006/career_copilot/blob/master/utils/pdf_parser.py"
click node_analyzer "https://github.com/siddhi472006/career_copilot/blob/master/agents/resume_analyzer.py"
click node_coordinator "https://github.com/siddhi472006/career_copilot/blob/master/agents/coordinator.py"
click node_matcher "https://github.com/siddhi472006/career_copilot/blob/master/agents/job_matcher.py"
click node_ats "https://github.com/siddhi472006/career_copilot/blob/master/agents/ats_optimizer.py"
click node_roadmap "https://github.com/siddhi472006/career_copilot/blob/master/agents/roadmap_agent.py"
click node_interview "https://github.com/siddhi472006/career_copilot/blob/master/agents/mock_interview.py"
click node_cover "https://github.com/siddhi472006/career_copilot/blob/master/agents/cover_letter.py"
click node_salary "https://github.com/siddhi472006/career_copilot/blob/master/agents/salary_predictor.py"
click node_recommend "https://github.com/siddhi472006/career_copilot/blob/master/agents/job_recommender.py"
click node_skillgap "https://github.com/siddhi472006/career_copilot/blob/master/agents/skill_gap_bridge.py"
click node_reverse "https://github.com/siddhi472006/career_copilot/blob/master/agents/reverse_pitch_agent.py"
click node_llm "https://github.com/siddhi472006/career_copilot/blob/master/utils/llm_client.py"
click node_websearch "https://github.com/siddhi472006/career_copilot/blob/master/agents/salary_predictor.py"
click node_auth "https://github.com/siddhi472006/career_copilot/blob/master/database/auth.py"
click node_otp "https://github.com/siddhi472006/career_copilot/blob/master/utils/otp_service.py"
click node_email "https://github.com/siddhi472006/career_copilot/blob/master/utils/email_service.py"
click node_models "https://github.com/siddhi472006/career_copilot/blob/master/database/models.py"
click node_db "https://github.com/siddhi472006/career_copilot/blob/master/database/db.py"

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_dashboard toneBlue
class node_fastapi,node_routes,node_mcp toneAmber
class node_parser,node_analyzer,node_coordinator,node_matcher,node_ats,node_roadmap,node_interview,node_cover,node_salary,node_recommend,node_skillgap,node_reverse toneMint
class node_auth,node_otp,node_models,node_db toneRose
class node_llm,node_websearch,node_jobplatforms,node_email,node_candidate toneIndigo
```

## Components

### User Experience

- [Streamlit Dashboard](https://github.com/siddhi472006/career_copilot/blob/master/frontend/app.py): `frontend/app.py`

### Service and Access

- [FastAPI Application](https://github.com/siddhi472006/career_copilot/blob/master/api/main.py): `api/main.py`
- [REST Routes](https://github.com/siddhi472006/career_copilot/blob/master/api/routes.py): `api/routes.py`
- [MCP Server](https://github.com/siddhi472006/career_copilot/blob/master/mcp_server.py): `mcp_server.py`

### Career Agents

- [Resume Parser](https://github.com/siddhi472006/career_copilot/blob/master/utils/pdf_parser.py): `utils/pdf_parser.py`
- [Resume Analyzer](https://github.com/siddhi472006/career_copilot/blob/master/agents/resume_analyzer.py): `agents/resume_analyzer.py`
- [Analysis Coordinator](https://github.com/siddhi472006/career_copilot/blob/master/agents/coordinator.py): `agents/coordinator.py`
- [Job Matcher](https://github.com/siddhi472006/career_copilot/blob/master/agents/job_matcher.py): `agents/job_matcher.py`
- [ATS Optimizer](https://github.com/siddhi472006/career_copilot/blob/master/agents/ats_optimizer.py): `agents/ats_optimizer.py`
- [Learning Roadmap](https://github.com/siddhi472006/career_copilot/blob/master/agents/roadmap_agent.py): `agents/roadmap_agent.py`
- [Mock Interview](https://github.com/siddhi472006/career_copilot/blob/master/agents/mock_interview.py): `agents/mock_interview.py`
- [Cover Letter](https://github.com/siddhi472006/career_copilot/blob/master/agents/cover_letter.py): `agents/cover_letter.py`
- [Salary Predictor](https://github.com/siddhi472006/career_copilot/blob/master/agents/salary_predictor.py): `agents/salary_predictor.py`
- [Job Recommender](https://github.com/siddhi472006/career_copilot/blob/master/agents/job_recommender.py): `agents/job_recommender.py`
- [Skill Gap Bridge](https://github.com/siddhi472006/career_copilot/blob/master/agents/skill_gap_bridge.py): `agents/skill_gap_bridge.py`
- [Reverse Pitch](https://github.com/siddhi472006/career_copilot/blob/master/agents/reverse_pitch_agent.py): `agents/reverse_pitch_agent.py`

### Identity and Data

- [Authentication](https://github.com/siddhi472006/career_copilot/blob/master/database/auth.py): `database/auth.py`
- [OTP Service](https://github.com/siddhi472006/career_copilot/blob/master/utils/otp_service.py): `utils/otp_service.py`
- [Domain Models](https://github.com/siddhi472006/career_copilot/blob/master/database/models.py): `database/models.py`
- [SQL Database](https://github.com/siddhi472006/career_copilot/blob/master/database/db.py): `database/db.py`

### AI and Integrations

- [LLM Client](https://github.com/siddhi472006/career_copilot/blob/master/utils/llm_client.py): `utils/llm_client.py`
- [Salary Web Search](https://github.com/siddhi472006/career_copilot/blob/master/agents/salary_predictor.py): `agents/salary_predictor.py`
- **Job Platforms**
- [Email Service](https://github.com/siddhi472006/career_copilot/blob/master/utils/email_service.py): `utils/email_service.py`

### Other components

- **Candidate**

## Connections

- Candidate → Streamlit Dashboard: uploads and views (evidence: `README.md`)
- Streamlit Dashboard → FastAPI Application: uses backend (evidence: `README.md`)
- FastAPI Application → REST Routes: registers routes (evidence: `api/main.py`)
- REST Routes → Analysis Coordinator: runs analysis (evidence: `api/routes.py`)
- Analysis Coordinator → Resume Analyzer: analyzes first (evidence: `agents/coordinator.py`)
- Resume Analyzer → Resume Parser: parses resume (evidence: `agents/resume_analyzer.py`)
- Analysis Coordinator → Job Matcher: calculates match (evidence: `agents/coordinator.py`)
- Analysis Coordinator → ATS Optimizer: runs in parallel (evidence: `agents/coordinator.py`)
- Analysis Coordinator → Learning Roadmap: runs in parallel (evidence: `agents/coordinator.py`)
- Analysis Coordinator → Mock Interview: runs in parallel (evidence: `agents/coordinator.py`)
- Analysis Coordinator → Cover Letter: runs in parallel (evidence: `agents/coordinator.py`)
- Analysis Coordinator → Salary Predictor: runs in parallel (evidence: `agents/coordinator.py`)
- REST Routes → Job Recommender: requests recommendations (evidence: `api/routes.py`)
- REST Routes → Skill Gap Bridge: generates bridge (evidence: `api/routes.py`)
- REST Routes → Reverse Pitch: requests pitch (evidence: `api/routes.py`)
- MCP Server → Resume Analyzer: exposes analysis (evidence: `mcp_server.py`)
- MCP Server → Job Matcher: exposes matching (evidence: `mcp_server.py`)
- MCP Server → ATS Optimizer: exposes optimization (evidence: `mcp_server.py`)
- MCP Server → Learning Roadmap: exposes roadmap (evidence: `mcp_server.py`)
- MCP Server → Mock Interview: exposes interview (evidence: `mcp_server.py`)
- MCP Server → Cover Letter: exposes letters (evidence: `mcp_server.py`)
- MCP Server → Salary Predictor: exposes prediction (evidence: `mcp_server.py`)
- REST Routes → Authentication: authenticates users (evidence: `api/routes.py`)
- REST Routes → OTP Service: uses OTP flows (evidence: `api/routes.py`)
- OTP Service → Email Service: sends email (evidence: `utils/otp_service.py`)
- REST Routes → Domain Models: queries records (evidence: `api/routes.py`)
- REST Routes → SQL Database: opens sessions (evidence: `api/routes.py`)
- SQL Database → Domain Models: registers models (evidence: `database/db.py`)
- Resume Analyzer → LLM Client: asks LLM (evidence: `agents/resume_analyzer.py`)
- Job Matcher → LLM Client: asks LLM (evidence: `agents/job_matcher.py`)
- ATS Optimizer → LLM Client: asks LLM (evidence: `agents/ats_optimizer.py`)
- Learning Roadmap → LLM Client: asks LLM (evidence: `agents/roadmap_agent.py`)
- Mock Interview → LLM Client: asks LLM (evidence: `agents/mock_interview.py`)
- Cover Letter → LLM Client: asks LLM (evidence: `agents/cover_letter.py`)
- Salary Predictor → LLM Client: asks LLM (evidence: `agents/salary_predictor.py`)
- Job Recommender → LLM Client: uses LLM (evidence: `agents/job_recommender.py`)
- Skill Gap Bridge → LLM Client: uses LLM (evidence: `agents/skill_gap_bridge.py`)
- Reverse Pitch → LLM Client: uses LLM (evidence: `agents/reverse_pitch_agent.py`)
- Salary Predictor → Salary Web Search: gathers context (evidence: `agents/salary_predictor.py`)
- REST Routes → Job Platforms: fetches job listings (evidence: `README.md`)
- Job Recommender → Job Platforms: searches platforms (evidence: `README.md`)
