Installation

You can use Sutro via the API, or using the Python SDK and CLI. There is no installation required to use the API directly, but you will need to install the SDK and CLI to use the Sutro CLI. To install the Sutro Python SDK and CLI, install via pip from PyPI:

[uv] pip install sutro

If you experience issues with installation, please reach out to us at [email protected] or join our Slack community.

Setting up your API key

Open the Sutro UI and create a deployment key from the API Keys panel. Configure both the Sutro deployment base URL and the one-time key reveal: If the panel is not visible, contact the Sutro team at [email protected] to create a key for you.

export SUTRO_API_URL="https://your-sutro-deployment.example.com"
export SUTRO_API_KEY="sk_..."

Both the Sutro deployment base URL and the same URL with /v1 appended are accepted. You can instead store both settings locally with the CLI:

sutro login

This prompts for the Sutro deployment URL and API key, validates them against that deployment, and saves them to ~/.sutro/config.json for future SDK and CLI commands with owner-only file permissions.