CLI

The urun CLI is the operator's tool for getting Python apps onto uRun GPUs and inspecting what is running. It ships as the PyPI package urun-cli and installs a single binary named urun.

What the CLI does

The CLI talks to the uRun control plane over HTTPS. Everything it does is scoped to the org your API key belongs to.

• Deploy a Python app — package the app directory, upload content-addressed blobs, register a manifest, and poll the build to readiness.
• Inspect what is running — list apps (with a derived status), live and historical sessions, and currently-provisioned GPU/instance capacity.
• Operate a single app — check status, scale replicas, set the session-concurrency limit, disable and re-enable.
• Federate identity — register a trusted external JWT provider so your own users can open sessions against your apps (the terminal twin of the console's Frontend Auth page).

A complete tour in four commands

uv tool install urun-cli              # install
urun login --api-key urun_xxxxxxxx    # authenticate
urun deploy app.py                    # ship your app to GPUs
urun app list                        # see it go ready

Where to go next

• Install — get the urun binary on your machine or in CI.
• Authentication — log in with a deploy API key.
• Deploy apps — urun deploy end to end.
• Manage apps — status, scale, concurrency, disable, enable.
• Sessions — list live and historical runs.
• Compute — see provisioned GPU capacity.
• Trusted JWKS — urun auth trust-jwk for customer-JWT auth.
• Command reference — every command, flag, and default.