How akash030605/job_hunt_assistant works
Job Hunt Assistant is a terminal workflow that turns a resume into a candidate profile, collects and filters company job postings, scores matches, drafts application emails, and optionally sends a digest. The CLI orchestrates both profile creation and job runs; configuration, normalized data models, and persistent JSON files support those stages. The README documents the three ATS integrations and terminal results. Source excerpts show the main orchestration and integrations; unsampled implementation details are omitted where their connections are not evidenced.
Main entry points: cli.py CLI Orchestrator · __main__.py Module Entry · config.py Settings Loader · fetcher.py ATS Job Fetcher
Components 21
CLI Workflow
- Module Entry
jobhunt-project/jobhunt/__main__.py - CLI Orchestrator
jobhunt-project/jobhunt/cli.py - Settings Loader
jobhunt-project/jobhunt/config.py - Run Preferences
jobhunt-project/config.yaml
Job Discovery
- Company Sources
jobhunt-project/companies.yaml - ATS Job Fetcher
jobhunt-project/jobhunt/fetcher.py - Public ATS APIs
- Free Prefilter
jobhunt-project/jobhunt/prefilter.py
Profile and Matching
- Resume Profile Parsing
jobhunt-project/jobhunt/llm.py - Resume PDF
jobhunt-project/resume.pdf - Candidate Profile
jobhunt-project/profile.json - Shared Data Models
jobhunt-project/jobhunt/models.py - Gemini API
- Scoring and Drafting
jobhunt-project/jobhunt/llm.py
Persistence and Delivery
- Seen Job Store
jobhunt-project/jobhunt/store.py - Seen Jobs
jobhunt-project/seen.json - Digest Output
jobhunt-project/out/digest.json - Terminal Results
jobhunt-project/jobhunt/cli.py - HTML Digest Mailer
jobhunt-project/jobhunt/mailer.py - SMTP Service
Other components
- Terminal User
Connections 21
- Terminal User → Module Entry: runs commands
README.md - Module Entry → CLI Orchestrator: starts app
jobhunt-project/jobhunt/__main__.py - CLI Orchestrator → Settings Loader: loads settings
jobhunt-project/jobhunt/cli.py - Settings Loader → Run Preferences: reads YAML
jobhunt-project/jobhunt/config.py - CLI Orchestrator → Company Sources: loads companies
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → ATS Job Fetcher: fetches jobs
jobhunt-project/jobhunt/cli.py - ATS Job Fetcher → Public ATS APIs: requests postings
jobhunt-project/jobhunt/fetcher.py - CLI Orchestrator → Free Prefilter: filters jobs
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → Resume PDF: reads PDF
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → Resume Profile Parsing: requests extraction
jobhunt-project/jobhunt/cli.py - Resume Profile Parsing → Gemini API: parses resume
jobhunt-project/jobhunt/llm.py - CLI Orchestrator → Candidate Profile: saves profile
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → Shared Data Models: builds scored jobs
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → Scoring and Drafting: scores and drafts
jobhunt-project/jobhunt/cli.py - Scoring and Drafting → Gemini API: scores and drafts
jobhunt-project/jobhunt/llm.py - CLI Orchestrator → Seen Job Store: checks and marks
jobhunt-project/jobhunt/cli.py - Seen Job Store → Seen Jobs: reads and writes
jobhunt-project/jobhunt/store.py - CLI Orchestrator → Digest Output: writes results
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → Terminal Results: prints table
jobhunt-project/jobhunt/cli.py - CLI Orchestrator → HTML Digest Mailer: sends digest
jobhunt-project/jobhunt/cli.py - HTML Digest Mailer → SMTP Service: sends email
jobhunt-project/jobhunt/mailer.py