Install with uv¶

uv is the recommended way to install URSA. It is fast, works well with isolated environments, and makes it easy to reproduce an installation.

Install uv¶

If you do not already have uv, install it from Astral's official installer:

macOS/LinuxWindows PowerShell

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

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

See the official uv installation guide for additional methods.

uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install ursa-ai

On Windows PowerShell, activate the environment with:

.\.venv\Scripts\Activate.ps1

uv pip install "ursa-ai[dashboard]"

Then verify:

ursa --help
ursa-dashboard --help

If you are creating a new project around URSA:

uv init -p 3.12 my-ursa-project
cd my-ursa-project
uv add ursa-ai

With dashboard support:

uv add "ursa-ai[dashboard]"

For command-line-only use, you can install URSA as a uv tool:

uv tool install ursa-ai

If you need the dashboard command from the tool installation:

uv tool install "ursa-ai[dashboard]"

For Python scripting, prefer a project or virtual environment installation so your scripts and URSA share the same environment.