Darwin Python SDK - Darwin

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

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. Regenerate rather than hand-editing SDK models when the public contract changes. Run the SDK quickstart.

Operations

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)

Last modified on September 21, 2026