Skip to content

Kairos

καιρός — the right moment to act

Kairos is a self-hosted job search platform for any region in its registry: it harvests boards, scores each posting against your resume and what you value, and archives closed ones. Use it from the command line (CLI) or browser (Web App) — all backed by a single FastAPI backend.

Search across platforms, analyze JDs with AI, tailor your resume per role, and track every application — your way.

Features

  • Multi-Source Search — Adzuna API (primary, free); Seek/JobsDB, LinkedIn, Tencent, ByteDance and Alibaba careers (opt-in)
  • LLM-Powered Analysis — Claude analyzes JDs, extracts requirements, scores match against your profile
  • Smart Resume Tailoring — Auto-rewrite resume sections per JD with anti-hallucination guards
  • API-First — Single FastAPI backend powers CLI and Web App (React)
  • Privacy First — All data in local PostgreSQL (Docker) or Supabase, API keys never leave your machine
  • Multi-Region — 21 markets out of the box, configured as data (Regions)

Documentation

Getting Started Installation, setup, first search
CLI Reference All commands with examples
API Reference Interactive API docs (Scalar) — run make backend first
Web App React frontend — search slice shipped
Architecture System design and data model

Semi-Automatic by Design

Kairos is intentionally semi-automatic. It handles the grunt work but keeps you in control:

  • You review every resume modification before saving
  • You click the final submit button in your browser
  • You decide which jobs to pursue based on match scores

Quick Start

# Clone and install
git clone https://github.com/Misoto22/kairos.git
cd kairos
uv sync

# First-time setup (API keys, database choice, preferences)
uv run kairos init

# Start database & run migrations
docker compose up -d postgres       # or use Supabase (no Docker needed)
uv run alembic upgrade head

# Search jobs
uv run kairos jobs search "software engineer" -c AU -l Sydney
uv run kairos jobs search "developer" -i     # interactive country/city picker