Quickstart

curl -fsSL https://inis.run/install.sh | bash

The installer adds a static inis binary to your PATH (macOS and Linux).

inis auth login

This opens app.inis.run in your browser. After you sign in, the CLI creates an API key and saves it to ~/.inis/credentials.

For CI or scripts, set INIS_API_KEY instead — see Authentication.

Stateless execution — no session needed:

inis run --language python -e 'print(42)'

Or run an arbitrary shell command in a fresh sandbox:

inis exec -- python -c "print(42)"

Persistent sessions keep state between commands:

SID=$(inis sessions create)
inis exec --session "$SID" -- pip install httpx -q
inis exec --session "$SID" -- python -c "import httpx; print(httpx.__version__)"
inis sessions destroy "$SID"

Installed packages live under /workspace and persist for the session.

Need a single run without tracking a session? Use the stateless-execution /v1/sessions/exec endpoint, which creates a session, runs your command, and tears it down in one call.

Building an agent? Read Concepts and Session lifecycle, then pick an integration. For terminal usage, see the CLI reference.

For a complete, runnable Python or TypeScript script covering this same session/exec/reconnect/cleanup sequence, see examples/quickstart in the public SDK mirror — it's the canonical source every quickstart snippet on this site is checked against.