What is hh-ai-agent?

This project is an automated job-application bot for HH.ru, a large Russian job-search website. It runs on its own, searching for openings, filtering out ones that do not fit, and sending out cover letters without a person doing that work by hand. The bot uses a local AI model, Llama 3, run through a tool called Ollama on your own computer rather than a paid cloud service. It reads a job posting alongside a summary of your skills and resume, then writes a personalized cover letter for that specific listing. It also runs a first pass of simple keyword filtering before the AI step, so postings containing certain unwanted words are skipped before any AI time is spent on them, and the AI is used again to catch mismatched listings that slipped through, such as sales or real estate roles that showed up under an IT search. To reach the site itself, the bot uses a browser automation tool called Playwright, which lets it act like a real person clicking through pages, including saving your login session so you do not have to sign in every single time. A companion Telegram bot handles control and reporting: it notifies you when the bot applies to a job, shares the generated cover letter, and forwards any replies from recruiters straight to your messages. Once set up, it loops continuously, checking for new postings every 30 minutes by default. Setup requires Python 3.9 or newer and Ollama installed locally with a Llama 3 model downloaded. You configure a Telegram token, your resume summary, and search terms in a couple of files, then log into HH.ru manually the first time so the bot can save your session. After that, it runs in the background. The author notes that automating actions on HH.ru goes against the site's terms of service, and using this bot is at your own risk.