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

# Darwin Python SDK

> Use a typed Darwin client in Python services, agents, and notebooks.

The Python SDK provides a typed client for Darwin's public v2 contract.

```bash theme={null}
pip install darwin-sdk
```

Import `Darwin` from `darwin_sdk` and pass a server-side token. Keep the token in your service environment or secret manager, not in notebook output or source control.

## Contract and types

Generated request and response models track the schemas shown in the [API Reference](/docs/reference/search). Regenerate rather than hand-editing SDK models when the public contract changes.

[Run the SDK quickstart](/docs/sdks/quickstart).

## Operations

```python theme={null}
found = darwin.search(query=query, limit=5)
action = darwin.start_action(
    capability_id=found.results[0].capability_id,
    capability_revision=found.results[0].capability_revision,
    request_id="stable-logical-mutation-id",
)
current = darwin.get_action(action.action_id)
```