# kulkarniparth30/resume-agent- architecture

> Architecture diagram of the GitHub repository kulkarniparth30/resume-agent-, 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/kulkarniparth30/resume-agent-
- Repository: https://github.com/kulkarniparth30/resume-agent-

## Overview

Resume-Agent is a career toolkit whose main workflow takes a candidate from resume and job-description analysis to ATS/rank scores, skill-gap recommendations, and follow-on learning or job discovery. Its React pages use a FastAPI API; backend services handle parsing, analysis, and generated recommendations. Separate product branches provide a live resume studio and a LangGraph career copilot with profile memory and tools. The graph reflects README-described capabilities where implementation excerpts are unavailable; some service-to-service links are omitted when the supplied evidence does not show the caller.

Main entry points: [`frontend/src/App.jsx`](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/App.jsx) (React application), [`backend/chatbot/tools.py`](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/tools.py) (Career tools), [`frontend/src/store/useAgentStore.js`](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/store/useAgentStore.js) (Client state), [`backend/services/llm_service.py`](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/llm_service.py) (LLM provider fallback)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Candidate experience"]
  node_webapp["React application<br/>[App.jsx]"]
  node_upload["Resume upload<br/>[Upload.jsx]"]
  node_dashboard["Analysis dashboard<br/>[Dashboard.jsx]"]
  node_studio["Resume studio<br/>[ResumeBuilder.jsx]"]
  node_jobfinder["Job finder<br/>[JobFinder.jsx]"]
  node_roadmappage["Roadmap view<br/>[Roadmap.jsx]"]
  node_frontendstate["Client state<br/>[useAgentStore.js]"]
end

subgraph group_analysis["Resume analysis"]
  node_resumeparse["Resume parser<br/>[resume_parser.py]"]
  node_analysisroute["Analysis endpoint<br/>[analyse.py]"]
  node_analyser["ATS and skill analysis<br/>[analyser.py]"]
  node_ai["LLM provider fallback<br/>[llm_service.py]"]
  node_enhancer["Resume enhancement<br/>[ai_enhancer.py]"]
end

subgraph group_career["Career recommendations"]
  node_roadmap["Roadmap generation"]
  node_learning["Learning resources<br/>[learn_service.py]"]
  node_jobs["Job search"]
end

subgraph group_copilot["Career copilot"]
  node_copilotroute["Chat endpoint<br/>[chat.py]"]
  node_agentgraph["Copilot state graph<br/>[graph.py]"]
  node_agenttools["Career tools<br/>[tools.py]"]
  node_guard["Topic guard<br/>[guard.py]"]
  node_memory[("Profile and chat memory<br/>[memory.py]")]
end

subgraph group_platform["API and persistence"]
  node_api["API client<br/>[client.js]"]
  node_apiapp["FastAPI router<br/>[main.py]"]
  node_authroute["Authentication endpoint<br/>[auth.py]"]
  node_supabase[("Cloud auth and history")]
  node_roadmapstore[("Saved roadmaps<br/>[roadmap_service.py]")]
end

node_candidate(("Candidate"))
node_externalllm{{"Gemini / Groq"}}
node_externaljobs{{"Job APIs"}}

node_candidate -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_upload
node_webapp -->|"routes to"| node_dashboard
node_webapp -->|"routes to"| node_studio
node_webapp -->|"routes to"| node_jobfinder
node_webapp -->|"routes to"| node_roadmappage
node_upload -->|"updates"| node_frontendstate
node_dashboard -->|"reads"| node_frontendstate
node_jobfinder -->|"reads"| node_frontendstate
node_studio -->|"requests"| node_api
node_upload -->|"requests"| node_api
node_api -->|"sends API requests"| node_apiapp
node_apiapp -->|"registers"| node_analysisroute
node_apiapp -->|"registers"| node_authroute
node_analysisroute -->|"calls"| node_analyser
node_analyser -.->|"uses"| node_ai
node_ai -->|"generates with"| node_externalllm
node_analyser -.->|"uses"| node_resumeparse
node_studio -.->|"requests enhancement"| node_enhancer
node_enhancer -->|"calls"| node_ai
node_roadmappage -.->|"loads saved plans"| node_roadmapstore
node_roadmap -.->|"generates with"| node_ai
node_jobfinder -->|"searches"| node_jobs
node_jobs -->|"queries"| node_externaljobs
node_roadmappage -.->|"browses resources"| node_learning
node_webapp -.->|"chat API requests"| node_copilotroute
node_apiapp -->|"registers"| node_copilotroute
node_copilotroute -->|"invokes"| node_agentgraph
node_agentgraph -->|"classifies"| node_guard
node_agentgraph -->|"dispatches tools"| node_agenttools
node_agenttools -->|"reads and updates"| node_memory
node_agenttools -->|"analyses resume"| node_analyser
node_agenttools -->|"generates roadmap"| node_roadmap
node_agenttools -->|"saves roadmap"| node_roadmapstore
node_agenttools -.->|"searches jobs"| node_jobs
node_agentgraph -->|"reasons with"| node_ai
node_authroute -->|"authenticates"| node_supabase
node_frontendstate -.->|"uses API client"| node_api
node_frontendstate -.->|"syncs history"| node_supabase

click node_webapp "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/App.jsx"
click node_upload "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Upload.jsx"
click node_dashboard "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Dashboard.jsx"
click node_studio "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/ResumeBuilder.jsx"
click node_jobfinder "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/JobFinder.jsx"
click node_roadmappage "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Roadmap.jsx"
click node_frontendstate "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/store/useAgentStore.js"
click node_api "https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/api/client.js"
click node_apiapp "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/main.py"
click node_resumeparse "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/resume_parser.py"
click node_analysisroute "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/analyse.py"
click node_analyser "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/analyser.py"
click node_ai "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/llm_service.py"
click node_enhancer "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/ai_enhancer.py"
click node_roadmap "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/roadmap_generator.py"
click node_learning "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/learn_service.py"
click node_jobs "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/job_search_service.py"
click node_copilotroute "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/chat.py"
click node_agentgraph "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/graph.py"
click node_agenttools "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/tools.py"
click node_guard "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/guard.py"
click node_memory "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/memory.py"
click node_authroute "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/auth.py"
click node_supabase "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/supabase_service.py"
click node_roadmapstore "https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/roadmap_service.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_webapp,node_upload,node_dashboard,node_studio,node_jobfinder,node_roadmappage,node_frontendstate toneBlue
class node_resumeparse,node_analysisroute,node_analyser,node_ai,node_enhancer toneAmber
class node_roadmap,node_learning,node_jobs,node_externaljobs toneMint
class node_copilotroute,node_agentgraph,node_agenttools,node_guard,node_memory toneRose
class node_api,node_apiapp,node_authroute,node_supabase,node_roadmapstore,node_candidate,node_externalllm toneIndigo
```

## Components

### Candidate experience

- [React application](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Resume upload](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Upload.jsx): `frontend/src/pages/Upload.jsx`
- [Analysis dashboard](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Resume studio](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/ResumeBuilder.jsx): `frontend/src/pages/ResumeBuilder.jsx`
- [Job finder](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/JobFinder.jsx): `frontend/src/pages/JobFinder.jsx`
- [Roadmap view](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/pages/Roadmap.jsx): `frontend/src/pages/Roadmap.jsx`
- [Client state](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/store/useAgentStore.js): `frontend/src/store/useAgentStore.js`

### Resume analysis

- [Resume parser](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/resume_parser.py): `backend/services/resume_parser.py`
- [Analysis endpoint](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/analyse.py): `backend/routes/analyse.py`
- [ATS and skill analysis](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/analyser.py): `backend/services/analyser.py`
- [LLM provider fallback](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/llm_service.py): `backend/services/llm_service.py`
- [Resume enhancement](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/ai_enhancer.py): `backend/services/ai_enhancer.py`

### Career recommendations

- [Roadmap generation](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/roadmap_generator.py): `backend/services/roadmap_generator.py`
- [Learning resources](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/learn_service.py): `backend/services/learn_service.py`
- [Job search](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/job_search_service.py): `backend/services/job_search_service.py`

### Career copilot

- [Chat endpoint](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/chat.py): `backend/routes/chat.py`
- [Copilot state graph](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/graph.py): `backend/chatbot/graph.py`
- [Career tools](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/tools.py): `backend/chatbot/tools.py`
- [Topic guard](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/guard.py): `backend/chatbot/guard.py`
- [Profile and chat memory](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/chatbot/memory.py): `backend/chatbot/memory.py`

### API and persistence

- [API client](https://github.com/kulkarniparth30/resume-agent-/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [FastAPI router](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/main.py): `backend/main.py`
- [Authentication endpoint](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/routes/auth.py): `backend/routes/auth.py`
- [Cloud auth and history](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/supabase_service.py): `backend/services/supabase_service.py`
- [Saved roadmaps](https://github.com/kulkarniparth30/resume-agent-/blob/main/backend/services/roadmap_service.py): `backend/services/roadmap_service.py`

### Other components

- **Candidate**
- **Gemini / Groq**
- **Job APIs**

## Connections

- Candidate → React application: uses
- React application → Resume upload: routes to (evidence: `frontend/src/App.jsx`)
- React application → Analysis dashboard: routes to (evidence: `frontend/src/App.jsx`)
- React application → Resume studio: routes to (evidence: `frontend/src/App.jsx`)
- React application → Job finder: routes to (evidence: `frontend/src/App.jsx`)
- React application → Roadmap view: routes to (evidence: `frontend/src/App.jsx`)
- Resume upload → Client state: updates (evidence: `frontend/src/pages/Upload.jsx`)
- Analysis dashboard → Client state: reads (evidence: `frontend/src/pages/Dashboard.jsx`)
- Job finder → Client state: reads (evidence: `frontend/src/pages/JobFinder.jsx`)
- Resume studio → API client: requests (evidence: `frontend/src/pages/ResumeBuilder.jsx`)
- Resume upload → API client: requests (evidence: `frontend/src/pages/Upload.jsx`)
- API client → FastAPI router: sends API requests
- FastAPI router → Analysis endpoint: registers (evidence: `backend/main.py`)
- FastAPI router → Authentication endpoint: registers (evidence: `backend/main.py`)
- Analysis endpoint → ATS and skill analysis: calls (evidence: `backend/routes/analyse.py`)
- ATS and skill analysis → LLM provider fallback: uses
- LLM provider fallback → Gemini / Groq: generates with (evidence: `backend/services/llm_service.py`)
- ATS and skill analysis → Resume parser: uses
- Resume studio → Resume enhancement: requests enhancement
- Resume enhancement → LLM provider fallback: calls (evidence: `backend/services/ai_enhancer.py`)
- Roadmap view → Saved roadmaps: loads saved plans
- Roadmap generation → LLM provider fallback: generates with
- Job finder → Job search: searches (evidence: `frontend/src/pages/JobFinder.jsx`)
- Job search → Job APIs: queries (evidence: `backend/services/job_search_service.py`)
- Roadmap view → Learning resources: browses resources
- React application → Chat endpoint: chat API requests
- FastAPI router → Chat endpoint: registers (evidence: `backend/main.py`)
- Chat endpoint → Copilot state graph: invokes (evidence: `backend/routes/chat.py`)
- Copilot state graph → Topic guard: classifies (evidence: `backend/chatbot/graph.py`)
- Copilot state graph → Career tools: dispatches tools (evidence: `backend/chatbot/graph.py`)
- Career tools → Profile and chat memory: reads and updates (evidence: `backend/chatbot/tools.py`)
- Career tools → ATS and skill analysis: analyses resume (evidence: `backend/chatbot/tools.py`)
- Career tools → Roadmap generation: generates roadmap (evidence: `backend/chatbot/tools.py`)
- Career tools → Saved roadmaps: saves roadmap (evidence: `backend/chatbot/tools.py`)
- Career tools → Job search: searches jobs
- Copilot state graph → LLM provider fallback: reasons with (evidence: `backend/chatbot/graph.py`)
- Authentication endpoint → Cloud auth and history: authenticates (evidence: `backend/routes/auth.py`)
- Client state → API client: uses API client
- Client state → Cloud auth and history: syncs history
