agentclientprotocol/python-sdk

Python SDK for ACP clients and agents.

What it solves

This project provides a Python SDK for the Agent Client Protocol (ACP), enabling developers to build agents and clients that can communicate using a standardized protocol. It removes the need to manually implement transport layers, JSON-RPC plumbing, and schema validation for ACP-compatible assistants.

How it works

The SDK provides several core components:

  • Schema Models: Generated Pydantic models that ensure payloads remain valid according to the latest ACP releases.
  • Transports: Asyncio-based transports, including stdio JSON-RPC plumbing, to handle the communication between agents and clients.
  • Helper Builders: Tools in acp.helpers for managing content blocks, tool calls, and session updates.
  • Lifecycle Helpers: Base classes and utilities that simplify the creation of custom agents.

Who it’s for

  • Agent Authors: Developers creating ACP-compatible assistants who need typed models and event-stream ergonomics.
  • Client Integrators: Those embedding ACP parties into Python applications or wrapping existing CLIs via stdio.
  • Tooling Teams: Teams experimenting with permission flows, streaming UX, or Gemini bridges.

Highlights

  • Spec Parity: Automatically tracks upstream ACP schema releases via Pydantic models.
  • Runtime Ergonomics: Uses asyncio and base classes to keep custom agent implementations small.
  • Example Gallery: Includes runnable demos for streaming, permissions, and Gemini bridges.
  • Contrib Utilities: Provides session accumulators, tool call trackers, and permission brokers based on real-world deployments.

Related

  • Project
    modelcontextprotocol/python-sdk

    A Python SDK that lets you build and consume servers following the Model Context Protocol, a standardized API for LLM‑to‑tool communication. It provides decorators for exposing functions as LLM‑usable tools/resources, supports stdio/HTTP/SSE transports, includes a CLI, and is documented at py.sdk.modelcontextprotocol.io.

  • Project
    a2aproject/a2a-python

    A Python SDK for building agentic applications that follow the Agent2Agent (A2A) Protocol for standardized inter-agent communication.

  • Project
    agentclientprotocol/agent-client-protocol

    Agent Client Protocol (ACP) is a language‑agnostic JSON‑RPC standard that lets code editors talk to generative‑AI coding agents. The repository provides the Rust schema crate, versioned JSON‑Schema files, and links to official SDKs (Kotlin, Java, Python, Rust, TypeScript). It defines a stable protocol version (1) negotiated at runtime, enabling editors and agents to interoperate without custom adapters.

  • Project
    modelcontextprotocol/go-sdk

    The official Go SDK for the Model Context Protocol (MCP), providing the tools to build standardized clients and servers for AI model interaction.

  • Project
    agentclientprotocol/claude-agent-acp

    An adapter that enables the Claude Agent SDK to work with Agent Client Protocol (ACP) compatible clients, supporting advanced agentic features like tool calls and subagent sessions.