Skip to content

Install with uv

For advanced users. uv installs yasp-agent either as a tool, with yasp and yasp-toolkit on your PATH everywhere, or into a project venv in place of pip. yasp-toolkit install detects both and runs uv for every later install.

This assumes you've already minted a registry key and exported it as REGISTRY_KEY. The variables below give uv the yasp registry as an index named yasp, with the key kept out of the URL:

export UV_INDEX="yasp=https://nexus.yasp.ai/repository/pypi-hosted/simple/"
export UV_INDEX_YASP_USERNAME=token
export UV_INDEX_YASP_PASSWORD="$REGISTRY_KEY"

No uv yet? See the uv installation guide.

Install as a tool

uv tool install yasp-agent

As with the venv install, this also exposes ytk as a short alias for yasp-toolkit. Run uv tool update-shell if uv warns that its tool directory is not on your PATH.

Install into a project venv

uv venv
source .venv/bin/activate
uv pip install yasp-agent

Add the products

Log in and add the products, as in Installation:

yasp-toolkit login
yasp-toolkit install gaia kronos-edge
yasp-toolkit runs from yasp-toolkit install runs
uv tool uv tool install, with the extras added to yasp-agent and every --package as --with, keeping the tool's existing requirements
uv venv uv pip install into the venv

The PyTorch build goes to uv as --torch-backend: cpu unless you pass --torch, then remembered.

yasp-toolkit install gaia kronos-edge --torch cu128

Verify:

yasp --help
yasp-toolkit --help

Update & uninstall

Update

yasp-toolkit install -U

The tool's receipt records the yasp index without the key, so update with yasp-toolkit install -U, which mints one, rather than uv tool upgrade.

Uninstall

uv tool uninstall yasp-agent
uv pip uninstall yasp-agent