How anantsharma-da/jobhunt works
JobHunt is a local-first India-focused job-search and application-tracking app. The main workflow is to search selected job sources, normalize and score results, store them for filtering, then save or track applications; users open the real application page and apply themselves. Separate branches support resume tailoring and PDF export, interview preparation and practice, reminders, and local insights. The README documents these capabilities; some implementation details and links for unsampled modules are therefore shown only at the level supported by the README or source index.
Main entry points: main.py Web API · search.py Search orchestration · insights.py Search and application insights · db.py Local SQLite data
Components 29
Job discovery
- Search orchestration
app/search.py - LinkedIn and Indeed
app/sources/boards.py - Naukri source
app/sources/naukri.py - Company career feeds
app/sources/ats.py - Company fallback search
app/sources/company_boards.py - Company imports
app/company_import.py - Applicant updates
app/applicant_update.py
Search and records
- Web API
app/main.py - Job normalization
app/normalize.py - Job matching
app/matching.py - Job warnings
app/job_warnings.py - Local SQLite data
app/db.py
Application support
- Resume tailoring
app/resume.py - Tailoring workflow
app/tailor_run.py - Resume PDF export
app/resume_pdf.py - Referral and recruiter messages
app/outreach.py - Interview question search
app/interview.py - Mock interview practice
app/practice.py - AI provider client
app/ai.py
Tracking and insights
- Application tracker
app/tracker.py - Scheduled searches
app/scheduler.py - Reminders and notices
app/notify.py - Search and application insights
app/insights.py
Other components
- Job seeker
- Web interface
static/index.html - AI providers
- Web question search
- Job sites
- Windows notifications
Connections 37
- Job seeker → Web interface: uses
README.md - Web interface → Web API: requests actions
README.md - Web API → Search orchestration: starts searches
app/main.py - Search orchestration → LinkedIn and Indeed: searches
app/search.py - Search orchestration → Naukri source: searches
app/search.py - Search orchestration → Company career feeds: fetches feeds
app/search.py - Search orchestration → Company fallback search: falls back to
app/search.py - Web API → Company imports: imports lists
app/main.py - Search orchestration → Job normalization: normalizes results
app/search.py - Search orchestration → Job matching: scores jobs
app/search.py - Search orchestration → Local SQLite data: stores results
app/search.py - Web API → Job warnings: checks adverts
app/main.py - Web API → Applicant updates: starts updates
app/main.py - Applicant updates → Local SQLite data: reads and updates
app/applicant_update.py - Web API → Application tracker: serves applications
app/main.py - Application tracker → Local SQLite data: reads records
app/tracker.py - Web API → Tailoring workflow: runs tailoring
app/main.py - Tailoring workflow → Resume tailoring: delegates tailoring
app/tailor_run.py - Resume tailoring → AI provider client: requests rewrites
app/resume.py - Web API → Resume PDF export: exports resumes
app/main.py - Web API → Referral and recruiter messages: drafts messages
app/main.py - Web API → Interview question search: finds questions
app/main.py - Web API → Mock interview practice: runs practice
app/main.py - Interview question search → Web question search: searches web
README.md - Mock interview practice → AI provider client: requests feedback
app/practice.py - AI provider client → AI providers: sends prompts
app/ai.py - Web API → Scheduled searches: configures schedules
README.md - Scheduled searches → Search orchestration: runs searches
app/scheduler.py - Scheduled searches → Reminders and notices: sends reminders
app/scheduler.py - Reminders and notices → Windows notifications: notifies
README.md - Web API → Search and application insights: serves insights
app/main.py - Search and application insights → Local SQLite data: reads records
app/insights.py - Search and application insights → Job matching: uses match logic
app/insights.py - Search and application insights → Application tracker: uses application data
app/insights.py - Job sites → LinkedIn and Indeed: provides listings
README.md - Job sites → Naukri source: provides listings
README.md - Job sites → Company career feeds: provides listings
README.md