How shengjidaguai-china/bosshunter works
BossHunter is a local job-search agent: users configure a résumé and search preferences, collect and score jobs, review candidates before any outreach, then prepare/send greetings and monitor HR responses. The CLI pipeline excerpt documents that sequence; the README adds multi-platform read-only collection, customized résumés, and workbench capabilities. The web service and database internals were only partially sampled, so their detailed route-to-handler wiring is not expanded here.
Main entry points: pipeline.py Full pipeline · db.py Job database · monitor.py Reply monitoring · App.tsx Web workbench
Components 21
User interfaces
- Web workbench
src/bosshunter/web/frontend/src/App.tsx - Web API
src/bosshunter/web/server.py - CLI
src/bosshunter/main.py
Job workflow
- Workbench tasks
src/bosshunter/web/tasks.py - Full pipeline
src/bosshunter/pipeline.py - Collection queue
src/bosshunter/collection/orchestrator.py - Platform collectors
src/bosshunter/collection/platforms - Job scoring
src/bosshunter/ai/scorer.py - Keyword prefilter
src/bosshunter/ai/prefilter.py - Human approval
src/bosshunter/ui/confirm.py - Greeting generation
src/bosshunter/ai/greeter.py
Browser automation
- Safe delivery
src/bosshunter/executor/sender.py - Browser client
src/bosshunter/browser/client.py - Chrome session
src/bosshunter/browser/session.py
Persistence and follow-up
- Reply monitoring
src/bosshunter/executor/monitor.py - Application status
src/bosshunter/tracker/status.py - Job database
src/bosshunter/db.py
Résumé handling
- Résumé tailoring
src/bosshunter/ai/resume.py - Résumé upload and preview
src/bosshunter/web/resume_upload.py
Other components
- Job seeker
- Recruiting platforms
Connections 27
- Job seeker → Web workbench: uses workbench
- Web workbench → Web API: requests data and tasks
- Job seeker → CLI: runs commands
- CLI → Full pipeline: starts full flow
- Web API → Workbench tasks: starts tasks
- Full pipeline → Collection queue: collects jobs
- Collection queue → Platform collectors: dispatches serially
- Platform collectors → Recruiting platforms: reads listings
- Collection queue → Job database: stores candidates
- Full pipeline → Job scoring: scores jobs
- Job scoring → Keyword prefilter: pre-filters
- Job scoring → Job database: reads and updates jobs
- Full pipeline → Human approval: requests review
- Job seeker → Human approval: approves jobs
- Full pipeline → Greeting generation: generates greetings
- Full pipeline → Safe delivery: sends approved greetings
- Safe delivery → Browser client: controls browser
- Browser client → Chrome session: sends runtime commands
- Chrome session → Recruiting platforms: interacts with BOSS
- Safe delivery → Job database: records delivery
- Full pipeline → Reply monitoring: starts monitoring
- Reply monitoring → Browser client: checks conversations
- Reply monitoring → Application status: updates follow-up status
- Reply monitoring → Job database: reads and records activity
- Web workbench → Résumé upload and preview: uploads and previews
- Résumé upload and preview → Résumé tailoring: provides résumé input
- Résumé tailoring → Job database: saves tailored résumé data