How siddhi472006/career_copilot works
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: routes.py REST Routes · llm_client.py LLM Client · coordinator.py Analysis Coordinator · mcp_server.py MCP Server
Components 25
User Experience
- Streamlit Dashboard
frontend/app.py
Service and Access
- FastAPI Application
api/main.py - REST Routes
api/routes.py - MCP Server
mcp_server.py
Career Agents
- Resume Parser
utils/pdf_parser.py - Resume Analyzer
agents/resume_analyzer.py - Analysis Coordinator
agents/coordinator.py - Job Matcher
agents/job_matcher.py - ATS Optimizer
agents/ats_optimizer.py - Learning Roadmap
agents/roadmap_agent.py - Mock Interview
agents/mock_interview.py - Cover Letter
agents/cover_letter.py - Salary Predictor
agents/salary_predictor.py - Job Recommender
agents/job_recommender.py - Skill Gap Bridge
agents/skill_gap_bridge.py - Reverse Pitch
agents/reverse_pitch_agent.py
Identity and Data
- Authentication
database/auth.py - OTP Service
utils/otp_service.py - Domain Models
database/models.py - SQL Database
database/db.py
AI and Integrations
- LLM Client
utils/llm_client.py - Salary Web Search
agents/salary_predictor.py - Job Platforms
- Email Service
utils/email_service.py
Other components
- Candidate
Connections 41
- Candidate → Streamlit Dashboard: uploads and views
README.md - Streamlit Dashboard → FastAPI Application: uses backend
README.md - FastAPI Application → REST Routes: registers routes
api/main.py - REST Routes → Analysis Coordinator: runs analysis
api/routes.py - Analysis Coordinator → Resume Analyzer: analyzes first
agents/coordinator.py - Resume Analyzer → Resume Parser: parses resume
agents/resume_analyzer.py - Analysis Coordinator → Job Matcher: calculates match
agents/coordinator.py - Analysis Coordinator → ATS Optimizer: runs in parallel
agents/coordinator.py - Analysis Coordinator → Learning Roadmap: runs in parallel
agents/coordinator.py - Analysis Coordinator → Mock Interview: runs in parallel
agents/coordinator.py - Analysis Coordinator → Cover Letter: runs in parallel
agents/coordinator.py - Analysis Coordinator → Salary Predictor: runs in parallel
agents/coordinator.py - REST Routes → Job Recommender: requests recommendations
api/routes.py - REST Routes → Skill Gap Bridge: generates bridge
api/routes.py - REST Routes → Reverse Pitch: requests pitch
api/routes.py - MCP Server → Resume Analyzer: exposes analysis
mcp_server.py - MCP Server → Job Matcher: exposes matching
mcp_server.py - MCP Server → ATS Optimizer: exposes optimization
mcp_server.py - MCP Server → Learning Roadmap: exposes roadmap
mcp_server.py - MCP Server → Mock Interview: exposes interview
mcp_server.py - MCP Server → Cover Letter: exposes letters
mcp_server.py - MCP Server → Salary Predictor: exposes prediction
mcp_server.py - REST Routes → Authentication: authenticates users
api/routes.py - REST Routes → OTP Service: uses OTP flows
api/routes.py - OTP Service → Email Service: sends email
utils/otp_service.py - REST Routes → Domain Models: queries records
api/routes.py - REST Routes → SQL Database: opens sessions
api/routes.py - SQL Database → Domain Models: registers models
database/db.py - Resume Analyzer → LLM Client: asks LLM
agents/resume_analyzer.py - Job Matcher → LLM Client: asks LLM
agents/job_matcher.py - ATS Optimizer → LLM Client: asks LLM
agents/ats_optimizer.py - Learning Roadmap → LLM Client: asks LLM
agents/roadmap_agent.py - Mock Interview → LLM Client: asks LLM
agents/mock_interview.py - Cover Letter → LLM Client: asks LLM
agents/cover_letter.py - Salary Predictor → LLM Client: asks LLM
agents/salary_predictor.py - Job Recommender → LLM Client: uses LLM
agents/job_recommender.py - Skill Gap Bridge → LLM Client: uses LLM
agents/skill_gap_bridge.py - Reverse Pitch → LLM Client: uses LLM
agents/reverse_pitch_agent.py - Salary Predictor → Salary Web Search: gathers context
agents/salary_predictor.py - REST Routes → Job Platforms: fetches job listings
README.md - Job Recommender → Job Platforms: searches platforms
README.md