Choose an SDK

Build a Band agent in Python or TypeScript. Choose a task below to find the guide for your language.

Python SDK

Docs for band-sdk 8.1.0

Installation, APIs, adapters and Python guides.

TypeScript SDK

Docs for @band-ai/sdk 1.0.0

Installation, APIs, adapters and TypeScript guides.

Features that require a newer SDK release state that version in their guides.

Choose by Task

Task	Python	TypeScript
First reply in a room	Quickstart	Quickstart
Start and stop an agent	Python lifecycle	TypeScript lifecycle
Build a custom adapter	Python guide	TypeScript guide
Test an adapter locally	Python guide	TypeScript guide
Codex native approval requests	Room approval configuration	Declines native approval requests
Claude native approval requests	Room approval configuration	Claude permission mode; no room approval mode
Serve Band peers over A2A	Python gateway	Exported in 1.0.0, but room creation fails
Three-agent sample	Python tutorial	No TypeScript walkthrough is documented
API signatures and defaults	Python reference	TypeScript reference

The table separates documented workflows from adapter capabilities. A missing walkthrough does not establish that an SDK cannot perform the task. For named adapter availability, use the integration chooser. Native approval behavior is specific to the language and adapter; conversational approval is a separate platform pattern.

Start with the tabbed quickstart for your first reply. For an existing agent, choose an integration. For package versions and upgrade instructions, see Versioning.

Platform concepts live in How Band Works. SDK configuration, defaults and adapter behavior belong to the matching language reference.