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

# Installation

> Add the Visceral SDK to a Python agent.

<Note>
  The SDK is pre-1.0. Signatures and framework coverage are still changing — treat
  the snippets here as the shape of the integration, not a pinned contract.
</Note>

## Requirements

* Python 3.12+

## Install

```bash theme={null}
pip install visceral-ai
```

The PyPI distribution is named `visceral-ai`. The import name is `visceral`:

```python theme={null}
import visceral
```

## Authenticate

The SDK reads your workspace API key from the environment:

```bash theme={null}
export VISCERAL_API_KEY="vsk_..."
```

You can create a key from the dashboard or the [CLI](/cli/overview). By default the
SDK reports to `https://api.visceralai.dev`.

Next: [instrument your agent](/sdk/instrumenting).