Hh AI Agent

HH AI Agent is an agent that automatically searches for vacancies on HH.ru. It evaluates them via LLM, generates cover letters, and sends suitable ones to Telegram.

Quick Start

Run python setup_wizard.py to start the setup wizard, which will guide you through all steps:

1. Telegram Bot token and your User ID
2. Choose AI provider (Ollama locally, Mistral API, or any OpenAI-compatible)
3. Your profile data for vacancy analysis
4. Working mode

It will create .env and profile.yaml, check configuration, and show next steps.

Working Modes

Mode	Description
dry_run	Searches and analyzes vacancies, sends previews in Telegram — no real applications
approval	Sends vacancy with a "Apply" button — apply only after you click

Start with dry_run. The vacancy card shows match explanation, company rating, and expandable cover letter.

LLM Providers

• Ollama (recommended): Local, free. Install Ollama and pull a model (e.g., llama3)
• Mistral API: Cloud, requires registration to get API key
• OpenAI-compatible: Any compatible endpoint (LocalAI, LM Studio, Groq, etc.)

Security

• Real application requires three simultaneous conditions: APP_MODE=approval + ENABLE_REAL_APPLY=true + clicking the button with your Telegram ID; one-time permission lasts 30 minutes after click
• No mass automatic mode
• .env, profile.yaml, and .browser-profile/ are excluded from Git
• Tokens, cookies, and full .env are not logged