This tool automates job applications on HH.RU, including applying to vacancies, updating resumes, and managing communications. It targets job seekers seeking to streamline their application process, offering a free, locally-run alternative to paid services.

How It Works

The utility bypasses HH.RU's API restrictions by emulating the official Android application, interacting primarily through its API. For actions not covered by the API, such as test completion, it leverages a headless browser. This hybrid approach ensures comprehensive automation while maintaining a command-line interface (CLI) and operating without a graphical environment.

Quick Start & Requirements

• Installation: Recommended via Docker (docker-compose run ...). Alternatives include pipx install 'hh-applicant-tool[playwright]' or traditional Python virtual environments.
• Prerequisites: Python >= 3.11. Docker and docker-compose for Docker installation. playwright for browser automation. pillow for sixel captcha support.
• Setup: Docker requires approximately 1GB disk space for Chromium.
• Documentation: API documentation is available via a web archive link in the README (docs/hhapi/openapi.yml).

Highlighted Details

• Cost: Fully free, contrasting with paid services costing 5,000-12,000 RUB/month.
• AI Integration: Supports OpenAI/ChatGPT for generating cover letters and chat responses.
• Application Features: Automates applying to vacancies, updating resumes, answering tests (currently random), and sending optional emails to employers.
• Communication: Enables broadcasting messages to employer chats to increase visibility.
• Data Management: Stores employer contacts and vacancy information locally in an SQLite database.
• Security & Reliability: Claims to protect personal data by not transmitting it externally and guarantees against account blocking by mimicking user requests.
• Multi-Account Support: Manages multiple HH.RU accounts and resumes through distinct profiles.
• CLI & Headless Operation: Designed for server environments, operating without a GUI or GPU. Captcha display is supported in terminals with kitty or sixel protocols.

Maintenance & Community

• Community: Active Telegram channel (HH Applicant Tool) and chat are available for discussion and support.
• Development: Open-source with a BTC address for project support.

Licensing & Compatibility

• License: Limited Non-Commercial License.
• Restrictions: Strictly prohibits commercial use, including integration into paid services or use by commercial entities. Permitted for personal study, learning, and integration into free, non-commercial products with attribution.

Limitations & Caveats

Test execution during applications is limited to random answer selection. The tool's interaction with the HH.RU API is noted as potentially unstable due to API design flaws. The author considers AI-generated cover letters superfluous as they are rarely read. Captcha rendering is dependent on terminal emulator capabilities (kitty/sixel protocols).