How kulkarniparth30/resume-agent- works
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: App.jsx React application · tools.py Career tools · useAgentStore.js Client state · llm_service.py LLM provider fallback
Components 28
Candidate experience
- React application
frontend/src/App.jsx - Resume upload
frontend/src/pages/Upload.jsx - Analysis dashboard
frontend/src/pages/Dashboard.jsx - Resume studio
frontend/src/pages/ResumeBuilder.jsx - Job finder
frontend/src/pages/JobFinder.jsx - Roadmap view
frontend/src/pages/Roadmap.jsx - Client state
frontend/src/store/useAgentStore.js
Resume analysis
- Resume parser
backend/services/resume_parser.py - Analysis endpoint
backend/routes/analyse.py - ATS and skill analysis
backend/services/analyser.py - LLM provider fallback
backend/services/llm_service.py - Resume enhancement
backend/services/ai_enhancer.py
Career recommendations
- Roadmap generation
backend/services/roadmap_generator.py - Learning resources
backend/services/learn_service.py - Job search
backend/services/job_search_service.py
Career copilot
- Chat endpoint
backend/routes/chat.py - Copilot state graph
backend/chatbot/graph.py - Career tools
backend/chatbot/tools.py - Topic guard
backend/chatbot/guard.py - Profile and chat memory
backend/chatbot/memory.py
API and persistence
- API client
frontend/src/api/client.js - FastAPI router
backend/main.py - Authentication endpoint
backend/routes/auth.py - Cloud auth and history
backend/services/supabase_service.py - Saved roadmaps
backend/services/roadmap_service.py
Other components
- Candidate
- Gemini / Groq
- Job APIs
Connections 39
- Candidate → React application: uses
- React application → Resume upload: routes to
frontend/src/App.jsx - React application → Analysis dashboard: routes to
frontend/src/App.jsx - React application → Resume studio: routes to
frontend/src/App.jsx - React application → Job finder: routes to
frontend/src/App.jsx - React application → Roadmap view: routes to
frontend/src/App.jsx - Resume upload → Client state: updates
frontend/src/pages/Upload.jsx - Analysis dashboard → Client state: reads
frontend/src/pages/Dashboard.jsx - Job finder → Client state: reads
frontend/src/pages/JobFinder.jsx - Resume studio → API client: requests
frontend/src/pages/ResumeBuilder.jsx - Resume upload → API client: requests
frontend/src/pages/Upload.jsx - API client → FastAPI router: sends API requests
- FastAPI router → Analysis endpoint: registers
backend/main.py - FastAPI router → Authentication endpoint: registers
backend/main.py - Analysis endpoint → ATS and skill analysis: calls
backend/routes/analyse.py - ATS and skill analysis → LLM provider fallback: uses
- LLM provider fallback → Gemini / Groq: generates with
backend/services/llm_service.py - ATS and skill analysis → Resume parser: uses
- Resume studio → Resume enhancement: requests enhancement
- Resume enhancement → LLM provider fallback: calls
backend/services/ai_enhancer.py - Roadmap view → Saved roadmaps: loads saved plans
- Roadmap generation → LLM provider fallback: generates with
- Job finder → Job search: searches
frontend/src/pages/JobFinder.jsx - Job search → Job APIs: queries
backend/services/job_search_service.py - Roadmap view → Learning resources: browses resources
- React application → Chat endpoint: chat API requests
- FastAPI router → Chat endpoint: registers
backend/main.py - Chat endpoint → Copilot state graph: invokes
backend/routes/chat.py - Copilot state graph → Topic guard: classifies
backend/chatbot/graph.py - Copilot state graph → Career tools: dispatches tools
backend/chatbot/graph.py - Career tools → Profile and chat memory: reads and updates
backend/chatbot/tools.py - Career tools → ATS and skill analysis: analyses resume
backend/chatbot/tools.py - Career tools → Roadmap generation: generates roadmap
backend/chatbot/tools.py - Career tools → Saved roadmaps: saves roadmap
backend/chatbot/tools.py - Career tools → Job search: searches jobs
- Copilot state graph → LLM provider fallback: reasons with
backend/chatbot/graph.py - Authentication endpoint → Cloud auth and history: authenticates
backend/routes/auth.py - Client state → API client: uses API client
- Client state → Cloud auth and history: syncs history