Skip to content

Kairos

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

Kairos is a Python-powered job application platform for the Australian market. 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.com.au, LinkedIn (scraper fallback)
  • 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 — AU, US, UK, CA, NZ with predefined city selection

Documentation
Getting Started Installation, setup, first search
CLI Reference All commands with examples
API Reference Interactive API docs (Scalar) — run ./start.sh 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