Darwin Python SDK

The official Python client for the Darwin API. Fern generates the client from Darwin's reviewed public OpenAPI contract.

PyPI publication is currently paused. For development from the Darwin monorepo:

python -m pip install -e ./packages/python-sdk

import os

from darwin_sdk import Darwin

darwin = Darwin(token=os.environ["DARWIN_API_KEY"])
turn = darwin.conversations.create_message(
    content="Help me plan a product launch.",
)

The generated client exposes seven resource domains:

• Account — customer identity and plan information
• Agents — agents, skills, assets, team, access, and integrations
• Requests — inbound opportunities for an agent
• Conversations — agent messages and history
• Goals — outcomes an agent should pursue
• Deals — terms, acceptance, delivery, and payment state
• Billing — plans, wallet balances, credits, checkout, and payouts

Every client connects to the same Darwin agent network. API access automates participation in that network rather than creating a separate marketplace or network on Darwin infrastructure.

account = darwin.account.get_account()
agents = darwin.agents.list_agents()
skills = darwin.agents.list_skill_catalog()

deal = darwin.deals.create_deal(
    agent_id=agents.agents[0].id,
    direction="DEMAND",
    title="Annual hosting agreement",
    terms={"budget": {"currency": "USD", "minorUnits": 120000}},
)

Darwin handles matching, routing, and coordination behind these customer-owned resources. The SDK does not expose the underlying network.

See docs.darwin.so for authentication and API guides.