git404hub

what is hh-ai-agent fr?

fikstt2/hh-ai-agent — explained in plain English

Analysis updated 2026-05-18

169PythonAudience · generalComplexity · 3/5Setup · moderate

tl;dr

An AI bot that automatically searches HH.ru job listings, filters out irrelevant ones, and writes personalized cover letters using a local Llama 3 model.

vibe map

mindmap
  root((hh-ai-agent))
    What it does
      Auto searches jobs
      Filters bad matches
      Writes cover letters
      Sends via Telegram
    Tech stack
      Python
      Playwright
      Ollama
      Llama 3
    Use cases
      Automate job hunting
      Screen listings
      Draft applications
    Audience
      Job seekers
      Russian speakers
      Automation tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically apply to job postings on HH.ru without manual searching.

VIBE 2

Generate a personalized cover letter for each job listing based on your resume.

VIBE 3

Get Telegram notifications and recruiter replies forwarded straight to your phone.

what's the stack?

PythonPlaywrightOllamaLlama 3Telegram Bot API

how it stacks up fr

fikstt2/hh-ai-agentzhaoyue4810/piankekouhxp/yapsnap
Stars169169167
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 1h+

Requires installing Ollama with a local Llama 3 model and manually logging into HH.ru on first run.

No license information is provided in the README.

in plain english

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.

prompts (copy fr)

prompt 1
Help me write a MY_RESUME_SUMMARY text for this bot's config.py based on my resume.
prompt 2
Explain how to set up Ollama locally and download the llama3 model for this project.
prompt 3
Show me how to edit the SEARCH_QUERIES list in config.py to search for a different job title.
prompt 4
Walk me through configuring the .env file with a Telegram bot token and user ID.

Frequently asked questions

what is hh-ai-agent fr?

An AI bot that automatically searches HH.ru job listings, filters out irrelevant ones, and writes personalized cover letters using a local Llama 3 model.

What language is hh-ai-agent written in?

Mainly Python. The stack also includes Python, Playwright, Ollama.

What license does hh-ai-agent use?

No license information is provided in the README.

How hard is hh-ai-agent to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is hh-ai-agent for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.