Hr Breaker

HR-Breaker

Resume optimization tool that transforms any resume into a job-specific, ATS-friendly PDF.


Features

• Any format in - LaTeX, plain text, markdown, HTML, PDF
• Optimized PDF out - Single-page, professionally formatted
• LLM-powered optimization - Tailors content to job requirements
• Minimal changes - Preserves your content, only restructures for fit
• No fabrication - Hallucination detection prevents made-up claims
• Opinionated formatting - Follows proven resume guidelines (one page, no fluff, etc.)
• Multi-filter validation - ATS simulation, keyword matching, structure checks
• Profile system - Group multiple resume documents into profiles with LLM-powered extraction and synthesis
• User instructions - Guide the optimizer with extra context ("Focus on Python", "Add K8s cert")
• Multi-language output - Auto-detect language from job/resume, or force a specific language (e.g. -l ru)
• Web UI + CLI - FastAPI + Alpine.js web app or command-line
• Debug mode - Inspect optimization iterations
• Cross-platform - Works on macOS, Linux, and Windows

How It Works

1. Upload resume in any text format (content source only)
2. Provide job posting URL or text description
3. LLM extracts content and generates optimized HTML resume
4. System runs internal filters (ATS simulation, keyword matching, hallucination detection)
5. If filters reject, regenerates using feedback
6. When all checks pass, renders HTML→PDF via WeasyPrint

Quick Start

# Install
uv sync

# Configure
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY (or configure another LLM provider)

# Run web UI (auto-opens browser at http://localhost:8899)
uv run hr-breaker serve

Usage

Web UI

Launch with `uv run hr-breaker serve` (default: http://localhost:8899)

1. Drop a file or paste text to create a resume profile (or click an existi