Skip to main content

Installation

Prerequisites:​

Ensure you have uv installed on your system. You can download it from docs.astral.sh.

The CLI requires Python 3.13 or newer. uv fetches and manages a compatible interpreter automatically, so a system-wide Python 3.13 is not required.

  uv tool install aichor-cli --index https://aichor-python-packages.aichor.ai
Dependency resolution issues

If you run into dependency resolution issues (e.g. version conflicts), try using the --index-strategy unsafe-best-match option:

uv tool install aichor-cli --index https://aichor-python-packages.aichor.ai --index-strategy unsafe-best-match
Option 2 — Install with pip 🐍 
pip install --extra-index-url https://aichor-python-packages.aichor.ai aichor-cli

Usage​

To use AIchor CLI, run the following command:

aichor

An output similar to the following should be displayed:

Usage: aichor [OPTIONS] COMMAND [ARGS]...

  AIchor CLI

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  auth         Authentication commands
  context      Manage the CLI context
  local-repo   Manage the local repo
  engines      Operations on engines
  experiments  Operations on experiments
  projects     Operations on projects
  storage      Operations on project storage

Upgrading​

To upgrade to the latest version, run:

uv tool upgrade aichor-cli

uv reuses the index recorded at install time, so the --index flag does not need to be passed again.

Still on an older version after upgrading?

uv tool upgrade only resolves versions compatible with the interpreter the tool was installed with. Because the CLI requires Python 3.13 or newer, a tool installed against an older interpreter (e.g. 3.11 or 3.12) will not upgrade past the last release that supported it. It stays put without raising an error.

The fix is to reinstall, pinning a compatible interpreter:

uv tool install aichor-cli --index https://aichor-python-packages.aichor.ai --python 3.13 --force

The interpreter a tool is bound to can be inspected with uv tool list.