How s3rgeym/hh-applicant-tool works
HH Applicant Tool is a local CLI and scriptable job-application assistant for HeadHunter. Users authorize an account, manage profiles and resumes, then apply to vacancies; application handling can generate cover letters, address tests, and send employer messages or email. A browser-based UI supports profile and preset management. Local storage retains resumes, vacancies, employer details, contacts, and settings. The README documents major capabilities that are not fully visible in sampled implementation excerpts; those branches are shown as unverified where wiring is not evidenced.
Main entry points: apply_vacancies.py Vacancy applications · client.py HeadHunter API · api.py Browser UI · main.py CLI runtime
Components 19
User entry
- CLI runtime
src/hh_applicant_tool/main.py - Browser UI
src/hh_applicant_tool/ui/api.py
Applications
- Vacancy applications
src/hh_applicant_tool/operations/apply_vacancies.py - Letter generation
src/hh_applicant_tool/ai/openai.py - Application tests
src/hh_applicant_tool/operations/apply_vacancies.py - Employer chat
src/hh_applicant_tool/operations/reply_employers.py - Employer email
src/hh_applicant_tool/operations/apply_vacancies.py - Chat autoresponder
src/hh_applicant_tool/operations/autoresponder.py
Accounts and profiles
- Browser authorization
src/hh_applicant_tool/operations/authorize.py - Profiles and presets
src/hh_applicant_tool/ui/profiles.py - HeadHunter API
src/hh_applicant_tool/api/client.py
Local persistence
- Storage facade
src/hh_applicant_tool/storage/facade.py - Data repositories
src/hh_applicant_tool/storage/repositories/base.py - Stored data models
src/hh_applicant_tool/storage/models/base.py - Local database
src/hh_applicant_tool/storage/utils.py
Other components
- Applicant
- HeadHunter
- OpenAI-compatible AI
- Employers
Connections 21
- Applicant → CLI runtime: runs commands
README.md - Applicant → Browser UI: uses browser UI
README.md - CLI runtime → HeadHunter API: creates client
src/hh_applicant_tool/main.py - CLI runtime → Storage facade: uses storage
src/hh_applicant_tool/main.py - Browser UI → Browser authorization: routes authorization
src/hh_applicant_tool/ui/api.py - Browser UI → Vacancy applications: routes applications
src/hh_applicant_tool/ui/api.py - Browser UI → Profiles and presets: uses profiles
src/hh_applicant_tool/ui/api.py - Profiles and presets → HeadHunter API: configures account
- Browser authorization → HeadHunter API: authorizes account
- Vacancy applications → HeadHunter API: requests vacancies
- HeadHunter API → HeadHunter: sends API requests
- Vacancy applications → Letter generation: generates letters
- Letter generation → OpenAI-compatible AI: requests generation
- Vacancy applications → Application tests: handles tests
src/hh_applicant_tool/operations/apply_vacancies.py - Vacancy applications → Employer email: sends email
src/hh_applicant_tool/operations/apply_vacancies.py - Vacancy applications → Employer chat: messages employers
- Chat autoresponder → Employers: replies in chats
- Vacancy applications → Storage facade: saves vacancy data
- Storage facade → Data repositories: creates repositories
src/hh_applicant_tool/storage/facade.py - Data repositories → Stored data models: maps records
src/hh_applicant_tool/storage/repositories/base.py - Data repositories → Local database: reads and writes