docs
CLI

Install

Install the urun CLI on your machine or in CI

The CLI is the PyPI package urun-cli. Installing it puts a single binary named urun on your PATH and makes the urun Python module importable (from urun import App) in that same environment — one package gives you both the deploy command and the compute library you write apps against. It requires Python 3.11 or newer.

Install

uv installs CLI tools into an isolated environment and puts the binary on your PATH. If you don't have it yet:

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

Then install the CLI:

uv tool install urun-cli
pip install urun-cli

Prefer a virtual environment, especially when this is also the environment you author your app in — the same install provides both the urun binary and the importable urun compute library:

python -m venv .venv
source .venv/bin/activate
pip install urun-cli

To run the CLI without installing it (handy in CI or a throwaway shell):

uvx urun-cli --version
uvx urun-cli deploy app.py

Verify

urun --version
urun <version>

One package, two faces: urun-cli installs the urun command (urun deploy, urun app list, …) and the importable urun compute library (from urun import App) you write your function against. There is no separate urun package on PyPI — installing urun-cli gives you both. The only other SDK is @urun-sh/core, the browser client covered in the TypeScript SDK. See the Python SDK for the library side.

Next

Authenticate before you deploy.

On this page