Skip to main content

What you’ll need

  • A Circuit account (to run/publish agents)
  • Bun installed (required for Circuit CLI)
  • Python 3.12+ with uv for Python agents, or Bun for TypeScript agents

Step 1: CLI

Install the Circuit CLI using Bun:
bun install -g @circuitorg/agent-cli
circuit --version

Step 2: SDK (Python OR TypeScript)

Choose either Python or TypeScript to develop your agent in, then install the respective SDK. If you use circuit new, the generated project already includes the SDK dependency in the project files.

Python SDK

Install the Circuit Agent SDK using uv:
uv pip install circuit-agent-sdk

TypeScript SDK

Install the Circuit Agent SDK using bun:
bun add @circuitorg/agent-sdk