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

# Connect a Python agent

> Install the Python SDK, apply the generated setup prompt, and verify your first live turn.

`rippletide-python` supports existing Python 3.10+ agents with synchronous and asyncio call sites. It has no model-provider dependencies: keep your provider and wrap its existing call sites. Provider streams can be traced. Responses streamed directly to the caller are evaluated after delivery and cannot be suppressed. Python MCP servers are not supported by this integration.

## Install and connect

Use your project's existing Python environment. If it has none, create one:

```bash theme={"system"}
python3 -m venv .venv
source .venv/bin/activate
python -m pip install rippletide-python
```

On Windows PowerShell, activate with `.venv\Scripts\Activate.ps1`. Record the dependency in your project's dependency manifest.

In the app, choose **Connect → Agent (Python)**, save the generated credentials in a git-ignored `.env`, and apply the generated prompt with your coding agent.

The Node.js CLI can also create the Python connection:

```bash theme={"system"}
npm install -g rippletide-package
rippletide login
rippletide connect --kind agent --language python --print-prompt
```

The CLI writes `RIPPLETIDE=rippletide://…` in the connected repository's `.env`. It does not install the Python package into your Python environment for you.

## Apply the setup prompt

Paste the generated prompt into your coding agent in the connected repository. It guides the instrumentation of your existing model calls, tool dispatcher and response delivery.

Prefer to add the instrumentation yourself? Follow [Manual Python setup](https://docs.rippletide.com/docs/manual-python-setup.md).

Runtime content capture is disabled by default. See [Privacy & capture](https://docs.rippletide.com/docs/privacy.md) before enabling `capture_content=True` on the client.

## Verify a real run

Run a turn that uses a guarded tool and delivers a response. Check `rippletide verify`, then `rippletide events --wait`. The app must show the inventory, heartbeat, tool and turn evidence, and the response-delivery outcome in **Traces**. Recording only a model candidate does not prove delivery. For a directly delivered stream, verification proves recorded delivery, not a pre-delivery enforcement boundary. See [Async and streaming](https://docs.rippletide.com/docs/manual-python-setup.md#async-and-streaming).


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