How nandavits/job-hunter works
Job Hunter is a personal job-search and application-preparation pipeline, with a human deliberately retaining the final submit action. The main flow gathers postings from public career feeds, the German federal job API, and read-only alert email; normalizes and filters them; persists matches and application status; prepares tailored documents; and sends a digest. The CLI also supports manual job entry, discovery, tracking, and browser form prefill. Relationships reflect the README and shown source references; unsampled implementation details are not inferred.
Main entry points: pipeline.py Daily pipeline · __main__.py Job Hunter CLI · __init__.py Source coordinator · models.py Normalized job record
Components 22
CLI and settings
- Job Hunter CLI
jobhunter/__main__.py - Settings loader
jobhunter/config.py
Job collection
- Source coordinator
jobhunter/collectors/__init__.py - Career-feed collectors
jobhunter/collectors/ats.py - Federal job API
jobhunter/collectors/arbeitsagentur.py - Alert-email parser
jobhunter/collectors/email_alerts.py - HTTP helpers
jobhunter/collectors/base.py
Matching and storage
- Normalized job record
jobhunter/models.py - Filter and score
jobhunter/filters.py - Job and tracker store
jobhunter/storage.py - Daily pipeline
jobhunter/pipeline.py
Application preparation
- CV and letter tailoring
jobhunter/tailor.py - Document generator
jobhunter/documents.py - Application form filler
jobhunter/autofill.py
Digest and review
- Digest and notifications
jobhunter/notify.py
Other components
- Job seeker
- Company career feeds
- Arbeitsagentur API
- Alert mailbox
- Claude API
- Telegram
- Human review
Connections 28
- Job seeker → Job Hunter CLI: runs commands
README.md - Job Hunter CLI → Settings loader: loads settings
jobhunter/__main__.py - Job Hunter CLI → Daily pipeline: runs search
jobhunter/__main__.py - Job Hunter CLI → Job and tracker store: manages jobs
jobhunter/__main__.py - Job Hunter CLI → Application form filler: fills forms
jobhunter/__main__.py - Daily pipeline → Source coordinator: collects jobs
jobhunter/pipeline.py - Source coordinator → Career-feed collectors: fetches boards
jobhunter/collectors/__init__.py - Source coordinator → Federal job API: fetches listings
jobhunter/collectors/__init__.py - Source coordinator → Alert-email parser: reads alerts
jobhunter/collectors/__init__.py - Source coordinator → HTTP helpers: creates session
jobhunter/collectors/__init__.py - Career-feed collectors → Company career feeds: reads feeds
README.md - Federal job API → Arbeitsagentur API: searches listings
jobhunter/collectors/arbeitsagentur.py - Alert-email parser → Alert mailbox: reads read-only
jobhunter/collectors/email_alerts.py - Career-feed collectors → Normalized job record: normalizes postings
jobhunter/collectors/ats.py - Federal job API → Normalized job record: normalizes postings
jobhunter/collectors/arbeitsagentur.py - Alert-email parser → Normalized job record: parses postings
jobhunter/collectors/email_alerts.py - Daily pipeline → Filter and score: filters and scores
jobhunter/pipeline.py - Daily pipeline → Job and tracker store: saves matches
jobhunter/pipeline.py - Filter and score → Normalized job record: scores records
jobhunter/filters.py - Job and tracker store → Normalized job record: stores records
jobhunter/storage.py - Daily pipeline → CV and letter tailoring: tailors candidates
jobhunter/pipeline.py - Daily pipeline → Document generator: generates documents
jobhunter/pipeline.py - Document generator → CV and letter tailoring: uses tailoring
jobhunter/documents.py - CV and letter tailoring → Claude API: requests tailoring
README.md - Daily pipeline → Digest and notifications: builds digest
jobhunter/pipeline.py - Digest and notifications → Telegram: sends digest
README.md - Application form filler → Human review: waits for review
README.md - Job seeker → Human review: reviews and submits
README.md