durable-agents-sdk 1.0.20260608003.dev0

Python SDK for the Durable Agents public API.

Durable Agents Python SDK

First-party Python SDK for the Durable Agents public API.

Install

Production:

pip install durable-agents-sdk

The SDK defaults to https://www.durableagents.ai. You can override the API base URL at runtime with base_url or DURABLE_API_BASE_URL.

Quickstart

import os

from durable_agents import DurableClient

client = DurableClient(api_key=os.environ["DURABLE_API_KEY"])
models = client.models.list()
print(models)
client.close()

Override the API base URL explicitly:

client = DurableClient(
    api_key=os.environ["DURABLE_API_KEY"],
    base_url="https://www.durableagents.ai",
)

Agents And Runs

agent = client.agents.create({
    "name": "SDK smoke agent",
    "instructions": "Reply concisely.",
})

run = client.agents.start(agent["id"], {
    "prompt": "Reply with READY only.",
})

Stream run events:

for event in client.runs.watch(run["id"]):
    print(event.event, event.data)

Data Sources

sources = client.sources.list(limit=50)
print(sources)

Pagination

for agent in client.agents.iterate(limit=100):
    print(agent)

Errors

from durable_agents import DurableApiError

try:
    client.models.list()
except DurableApiError as error:
    print(error.status_code, error.code, error.request_id, error.details)
    raise

Generated Client

The public compatibility surface is DurableClient. Kiota-generated low-level code is also available under durable_agents.generated for advanced users, but it is not the primary ergonomic API.