How will825/job-hunter works
Job Hunter is a self-hosted job-search application: it gathers postings from company ATS boards and aggregators, enriches and scores them against a local profile, then presents matches in a dashboard or sends a daily digest. The shared scan pipeline is the principal route from watched sources to stored results; the web API and CLI initiate or expose that workflow. The README documents dashboard features and optional integrations beyond the sampled route excerpts; those are represented at the server/UI level. Some internal calls are supported by the SOURCE INDEX rather than complete excerpts.
Main entry points: pipeline.rs Scan pipeline · server.rs Web API · main.rs CLI commands · mod.rs Fetcher dispatch
Components 23
Job sourcing
- Scan pipeline
src/pipeline.rs - Watchlist sources
src/sources.rs - Fetcher dispatch
src/fetchers/mod.rs - ATS fetchers
src/fetchers/greenhouse.rs - Aggregator fetchers
src/fetchers/adzuna.rs - Careers URL detection
src/detect.rs - Custom page reader
src/custom_page.rs
Enrichment and scoring
- Normalized job model
src/models.rs - Text and dedup
src/text.rs - Job classification
src/classify.rs - User profile
src/profile.rs - Keyword scoring
src/score.rs - LLM scoring
src/llm.rs
Local persistence
- SQLite database
src/db.rs
User interfaces
- CLI commands
src/main.rs - Web dashboard
src/web/index.html - Web API
src/server.rs
Notifications
- Digest email
src/email.rs
Other components
- Job seeker
- ATS boards
- Job aggregators
- Groq API
- Resend API
Connections 32
- Job seeker → CLI commands: runs commands
README.md - Job seeker → Web dashboard: uses dashboard
README.md - Web dashboard → Web API: calls API
src/server.rs - CLI commands → Scan pipeline: starts scans
src/main.rs - Web API → Scan pipeline: starts scans
src/server.rs - Scan pipeline → Watchlist sources: loads watchlist
src/pipeline.rs - Scan pipeline → Fetcher dispatch: fetches sources
src/pipeline.rs - ATS boards → ATS fetchers: provides postings
README.md - Job aggregators → Aggregator fetchers: provides postings
README.md - Fetcher dispatch → ATS fetchers: dispatches to
src/fetchers/mod.rs - Fetcher dispatch → Aggregator fetchers: dispatches to
src/fetchers/mod.rs - Scan pipeline → Normalized job model: processes jobs
src/pipeline.rs - ATS fetchers → Normalized job model: normalizes postings
src/fetchers/mod.rs - Aggregator fetchers → Normalized job model: normalizes postings
src/fetchers/mod.rs - Normalized job model → Text and dedup: computes dedup key
src/models.rs - Scan pipeline → Job classification: classifies jobs
src/pipeline.rs - Scan pipeline → Keyword scoring: scores jobs
src/pipeline.rs - Scan pipeline → User profile: uses profile
src/pipeline.rs - Keyword scoring → User profile: uses scoring profile
src/score.rs - Scan pipeline → LLM scoring: reranks shortlist
src/pipeline.rs - Custom page reader → LLM scoring: extracts job listings
src/custom_page.rs - Web API → Careers URL detection: validates careers URL
src/server.rs - Careers URL detection → Fetcher dispatch: validates board
src/detect.rs - Scan pipeline → Custom page reader: reads custom pages
src/pipeline.rs - LLM scoring → Groq API: requests scoring
README.md - Scan pipeline → SQLite database: stores scan results
src/pipeline.rs - Web API → SQLite database: reads and updates
src/server.rs - Web API → Web dashboard: serves embedded UI
README.md - CLI commands → SQLite database: reads and updates
src/main.rs - CLI commands → Digest email: sends digest
src/main.rs - Digest email → SQLite database: loads and marks matches
src/email.rs - Digest email → Resend API: sends email
README.md