Skip to content

Latest commit

History

History

README.md

ARCP Python SDK

The Agent Runtime Control Protocol (ARCP) Python SDK implements ARCP v1.1 — a message protocol for autonomous agent job submission, streaming, observability, and lifecycle control.

Install

pip install arcp
# or with uv:
uv add arcp

Requires Python 3.11+.

Start here

Getting startedFive-minute end-to-end example
ArchitectureHow the SDK is structured and why
ConformanceWhich spec sections are implemented

Guides

One guide per ARCP spec section:

GuideSpec
Sessions§6 — Session lifecycle
Stream resume§6.3 — Resuming interrupted streams
Authentication§6.1 — Bearer tokens and custom verifiers
Jobs§7 — Submitting and running jobs
Job events§8 — Event kinds and typed payloads
Leases§9 — Cost and time budgets
Delegation§10 — Agent-to-agent trust chains
Observability§11 — Logging, tracing, and metrics
Errors§12 — Typed exceptions
Vendor extensions§15 — Custom x-* fields

Reference

TransportsIn-memory, WebSocket, stdio
CLIarcp serve, submit, tail, replay
TroubleshootingCommon errors and fixes

Recipes

See recipes.md for a full index of runnable examples.

Links