YAHR – Yet Another HR

   page       attach   
abstract

YAHR is a command-line tool that acts as your personal career co-pilot. It reads your resume, searches for relevant job openings, scores them against your profile, and tells you exactly how to improve your CV to maximize your chances — all from the terminal.

Built on the A2A Protocol (an open standard for agent-to-agent communication), YAHR is composed of four specialized agents that work together under a single orchestrator:

  • Job Searcher Agent — queries web search APIs to discover open positions matching your background
  • Matching/Ranker Agent — parses your CV into a structured profile and scores each job against it
  • CV Assistant Agent — analyzes the gaps between your profile and the top-ranked jobs, then gives you concrete suggestions to strengthen your resume
  • Orchestrator Agent — ties everything together and exposes the full workflow through an intuitive CLI interface

The whole system is written in Python. The CLI is built with Typer + Rich for colored, structured output.
Each agent's reasoning comes from an LLM, accessed through OpenRouter so the system stays model-agnostic.
Architecturally, each agent is a standalone HTTP server, not a module inside one program.

outcomes