> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sutro.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK

> Install the Sutro SDK and choose an interface.

# Python SDK

```bash theme={null}
pip install sutro
# or: uv pip install sutro
```

Configure the client using the [authentication guide](/reference/authentication),
then import the shared client:

```python theme={null}
import sutro as so
```

For an isolated client, instantiate `Sutro` directly:

```python theme={null}
from sutro import Sutro

client = Sutro(api_url="https://your-sutro-deployment.example.com", api_key="sk_...")
```

Both interfaces use your Sutro deployment's API routes. Configure a URL
and a key from the same deployment; the SDK has no shared default API endpoint.

## Interfaces

| Interface | Purpose |
| - | - |
| [`run_function()`](/reference/python-sdk/run-function) | Run a published Function on one input and wait for the answer |
| [`batch_run_function()`](/reference/python-sdk/functions) | Run a published Function over a table as a Batch job |
| [`infer()`](/reference/python-sdk/batch-inference) | Run a standalone model |
| [`infer_per_model()`](/reference/python-sdk/batch-inference#run-multiple-models) | Submit the same input to several models |
| [Job methods](/reference/python-sdk/job-methods) | Monitor, retrieve, download, list, or cancel jobs |
| [Remote inputs](/reference/python-sdk/presigned-s3-inputs) | Submit large CSV or Parquet objects by HTTPS URL |

`base_url`, `set_base_url()`, and `serving_base_url` are deprecated. Use
`api_url` or `set_api_url()`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.