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

# Installation

> Install the SDK in your agent project and point it at your Rubric API.

The SDK is what lives in your agent process. You install it as a regular Python package and point it at the Rubric API URL we gave you.

## SDK

The Python SDK is published as `rubric` on PyPI.

<CodeGroup>
  ```bash pip theme={null}
  pip install rubric-app
  ```

  ```bash uv theme={null}
  uv add rubric-app
  ```

  ```bash poetry theme={null}
  poetry add rubric-app
  ```
</CodeGroup>

### Optional extras

Choose the extra(s) matching your agent framework. Each extra is a thin adapter that wraps the framework's tool-dispatch hook so every call is governed.

| Extra                  | When to use it                                                         |
| ---------------------- | ---------------------------------------------------------------------- |
| `rubric[mcp]`          | Anything that speaks the Model Context Protocol.                       |
| `rubric[claude-agent]` | Claude Agent SDK (`claude-agent-sdk`).                                 |
| `rubric[langchain]`    | LangChain `BaseTool` lists.                                            |
| `rubric[runtime]`      | Optional native evaluator backend (Rust). Faster, identical semantics. |
| `rubric[presidio]`     | Presidio-backed DLP detection.                                         |

You can stack them: `pip install 'rubric-app[mcp,runtime,presidio]'`.

## Configure

The SDK reads its configuration from environment variables:

```bash theme={null}
export AG_ENROLLMENT_TOKEN=enr_…       # mint one in the dashboard's Enrollment page
export AG_AGENT_NAME=my-bot            # stable per-agent name
export AG_API_URL=https://api.your-rubric-url.example.com   # the URL we gave you
```

`AG_API_URL` is the Rubric API URL you received during onboarding. Set it in your deployment's secret manager alongside the enrollment token.

## Verify

Hit Rubric's health endpoint to confirm reachability:

```bash theme={null}
curl "$AG_API_URL/health"
# {"ok":true}
```

Then walk through the [Quickstart](/guides/quickstart) to enroll your first agent.