How sunilbelde/job-hunt-hq works
job-hunt-hq is a locally hosted job-application service. A user or external tool records a posting, then requests a resume or cover letter; the service retrieves the stored application, generates and checks a document, saves it locally, and exposes job status. The local viewer also supports application management and form-filling workflows, while email-status updates and applying from a link are separate capabilities. Relationships are based on the README and supplied source excerpts/index; some route details and subsystem internals were not sampled.
Main entry points: main.py HTTP API · cover_letter.py Cover Letter Writing · generation.py Resume Selection · tailoring.py Resume Tailoring
Components 17
Service API
- HTTP API
app/main.py - Local Listeners
app/serve.py - Request Models
app/models.py
Applications
- Application Store
app/applications.py - Application Record
app/models.py
Document Generation
- Resume Selection
app/generation.py - Resume Tailoring
app/tailoring.py - Cover Letter Writing
app/cover_letter.py - PDF Rendering
app/rendering.py
Viewer Workflows
- Resume Viewer
app/viewer.py - Form Filler
app/form_filler.py
Local Runtime
- Configuration
app/settings.py - Document Storage
app/storage.py
Other components
- User or Tool
- Claude Code
- Tectonic
- Herdr
Connections 20
- User or Tool → Local Listeners: sends requests
README.md - Local Listeners → HTTP API: routes requests
app/serve.py - HTTP API → Configuration: uses config
app/main.py - HTTP API → Request Models: validates requests
app/main.py - HTTP API → Application Store: records and updates
app/main.py - Application Store → Application Record: stores records
app/applications.py - HTTP API → Resume Selection: starts resume job
README.md - Resume Selection → Resume Tailoring: scores and tailors
app/generation.py - Resume Selection → PDF Rendering: renders base PDF
app/generation.py - Resume Tailoring → Claude Code: runs skill
app/tailoring.py - PDF Rendering → Tectonic: compiles TeX
app/rendering.py - HTTP API → Cover Letter Writing: starts letter job
README.md - Cover Letter Writing → Resume Tailoring: uses run support
app/cover_letter.py - Cover Letter Writing → Claude Code: runs writing skill
app/cover_letter.py - Cover Letter Writing → PDF Rendering: renders PDF
app/cover_letter.py - HTTP API → Document Storage: saves outputs
README.md - HTTP API → Resume Viewer: serves viewer
README.md - Resume Viewer → HTTP API: calls viewer endpoints
app/viewer.py - HTTP API → Form Filler: starts form filling
app/main.py - Form Filler → Herdr: opens workspace tabs
app/form_filler.py