How shujaullah-dev/autonomous-job-application-agent works
AI Job Agent is a FastAPI backend for candidate profiles and job discovery, with additional resume review, matching, and application-management routes. The main user journey is to maintain a profile, preview and explicitly approve resume-derived records, then discover and compare jobs; job ingestion also runs through provider-specific import tooling. Further routes support drafting and tracking applications, interviews, and follow-ups. The README documents the core profile, resume, and Greenhouse/Lever capabilities; several newer subsystems are represented from the source index, so their internal behavior is not inferred beyond cited references.
Main entry points: main.py FastAPI application · job_matches.py Job matching · job_recommendations.py Recommendations · application_tracking.py Tracking service
Components 24
API entry and profiles
- FastAPI application
backend/app/main.py - Profile management
backend/app/api/routes
Resume processing
- Resume endpoints
backend/app/api/routes/resumes.py - Resume import
backend/app/api/routes/resume_imports.py - Resume parsing
backend/app/services
Job discovery and matching
- Job search
backend/app/api/routes/jobs.py - Provider adapters
backend/app/services/job_sources - Job ingestion
backend/app/services/job_ingestion.py - Job matching
backend/app/api/routes/job_matches.py - Recommendations
backend/app/api/routes/job_recommendations.py - Match scoring
backend/app/services/job_matching.py - Candidate and job queries
backend/app/services/matching_queries.py - Semantic similarity
backend/app/services/vector_store.py
Application lifecycle
- Job workflows
backend/app/api/routes/job_workflows.py - Application materials
backend/app/api/routes/application_materials.py - Application tracking
backend/app/api/routes/application_tracking.py - Follow-ups
backend/app/api/routes/application_follow_ups.py - Interviews
backend/app/api/routes/interviews.py - Tracking service
backend/app/services/application_tracking.py
Persistence
- Application records
backend/app/models/application.py - Job records
backend/app/models/job.py - Candidate records
backend/app/models/candidate.py - SQL database
Other components
- API user
Connections 30
- API user → FastAPI application: sends requests
backend/app/main.py - FastAPI application → Profile management: registers routes
backend/app/main.py - FastAPI application → Resume endpoints: registers routes
backend/app/main.py - FastAPI application → Resume import: registers routes
backend/app/main.py - FastAPI application → Job search: registers routes
backend/app/main.py - FastAPI application → Job matching: registers routes
backend/app/main.py - FastAPI application → Recommendations: registers routes
backend/app/main.py - FastAPI application → Job workflows: registers routes
backend/app/main.py - FastAPI application → Application materials: registers routes
backend/app/main.py - FastAPI application → Application tracking: registers routes
backend/app/main.py - FastAPI application → Follow-ups: registers routes
backend/app/main.py - FastAPI application → Interviews: registers routes
backend/app/main.py - Resume endpoints → Resume parsing: uses services
- Resume import → Resume parsing: uses services
- Provider adapters → Job ingestion: supplies listings
README.md - Job ingestion → Job records: writes jobs
backend/app/services/job_ingestion.py - Job matching → Match scoring: calls scoring
backend/app/api/routes/job_matches.py - Job matching → Candidate and job queries: loads match data
backend/app/api/routes/job_matches.py - Job matching → Semantic similarity: queries similarity
backend/app/api/routes/job_matches.py - Recommendations → Match scoring: ranks jobs
backend/app/api/routes/job_recommendations.py - Recommendations → Candidate and job queries: loads job pool
backend/app/api/routes/job_recommendations.py - Recommendations → Semantic similarity: queries similarity
backend/app/api/routes/job_recommendations.py - Job workflows → Application materials: coordinates drafts
backend/app/api/routes/application_materials.py - Application tracking → Tracking service: calls tracking
backend/app/api/routes/application_tracking.py - Follow-ups → Tracking service: uses tracking
backend/app/api/routes/application_follow_ups.py - Interviews → Tracking service: uses tracking
backend/app/api/routes/interviews.py - Tracking service → Application records: reads and writes
backend/app/services/application_tracking.py - Application records → SQL database: persists records
- Job records → SQL database: persists records
- Candidate records → SQL database: persists records