Getting Started

WIP — Kairos is under active development. This page describes the planned setup flow.

Prerequisites

• Rust toolchain (1.80+)
• A Claude API key from Anthropic Console
• Chrome/Chromium (for Indeed scraping via headless browser)

Installation

git clone https://github.com/Misoto22/kairos.git
cd kairos

Install:

# API server (required — the single backend for all frontends)
cargo install --path crates/kairos-api

# CLI (command-line client)
cargo install --path crates/kairos

First-Time Setup

kairos init

This interactive wizard will:

1. Create config at ~/.config/kairos/config.toml
2. Ask for your Claude API key (stored locally, never transmitted elsewhere)
3. Set up your profile (name, location, target roles)
4. Initialize the SQLite database at ~/.local/share/kairos/kairos.db

Import Your Resume

kairos resume import ~/resume.tex

Supports LaTeX (.tex) and Markdown (.md) formats. The parser splits your resume into sections and marks which ones are tailorable by the LLM.

Tailorable sections (LLM can modify):

• Summary / Professional Profile
• Technologies / Skills
• Work experience bullet points

Protected sections (never modified):

• Education, dates, company names
• Contact information, references

Launch

Start the API Server

The API server is the single backend for all frontends — it must be running first:

kairos-server                        # start API on localhost:3001

Use the CLI

kairos jobs search "software engineer" --location perth
kairos jobs list --min-score 0.7
kairos resume tailor --job-id <uuid>

Or open the Web App at http://localhost:3001 (when available).

Configuration

Edit ~/.config/kairos/config.toml directly or use the CLI:

[profile]
name = "Your Name"
location = "Perth WA"
country = "AU"
target_roles = ["Software Engineer", "Backend Developer"]

[api]
claude_api_key = ""  # or set KAIROS_CLAUDE_API_KEY env var
claude_model = "claude-sonnet-4"

[search.defaults]
platforms = ["seek", "indeed"]
location = "Perth"
job_type = "fulltime"
salary_min = 70000
posted_within_days = 14

Tip: API keys can also be set via environment variable KAIROS_CLAUDE_API_KEY, which takes precedence over the config file.