21st-sdk

21st-sdk Python

Server-side Python SDK for 21st Agents. Manage sandboxes, threads, and tokens programmatically.

Method arguments use Python-style snake_case, but SDK responses keep the relay's camelCase field names.

Install

pip install 21st-sdk

Quick Start

import os

from twentyfirst_sdk import AgentClient

client = AgentClient(api_key=os.environ["API_KEY_21ST"])  # an_sk_...

# Create a sandbox for your agent
sandbox = client.sandboxes.create(agent="my-agent")

# Create a thread
thread = client.threads.create(sandbox_id=sandbox.id, name="Review PR #42")

# Generate a short-lived token for browser clients
token = client.tokens.create(agent="my-agent", expires_in="1h")
print(token.expiresAt)

API

AgentClient(api_key, base_url=...)

AgentClient(
    api_key="...",   # Your an_sk_ API key
    base_url="...",  # Optional, default: "https://relay.an.dev"
)

client.sandboxes

client.threads

client.tokens

License

MIT