Skip to content
Learn KAOS

Install

You need exactly one tool to run every example on this site: uv, the fast Python package manager. The examples are self-contained PEP 723 scripts that declare their own dependencies, so uv resolves and runs them in an isolated, cached environment — no manual virtualenv, no pip install.

  1. Install uv

    Terminal window
    curl -LsSf https://astral.sh/uv/install.sh | sh

    Verify it’s on your path:

    Terminal window
    uv --version

  2. Python 3.13+

    KAOS packages require Python 3.13 or newer — but you don’t need to install it yourself. uv fetches a matching interpreter on demand. To see what you have:

    Terminal window
    uv python list

  3. Run an example

    That’s the whole setup. Every example runs with one command — straight from GitHub:

    Terminal window
    uv run https://raw.githubusercontent.com/273v/learn-kaos/main/examples/citations-extract.py

    …or, if you’ve cloned the repo:

    Terminal window
    uv run examples/citations-extract.py

The first run downloads dependencies (cached afterward), then prints the result. Head to your first example for the walkthrough.