Deep Agents ACP

0.0.6 verified Sat May 09 auth: no python

Agent Client Protocol (ACP) integration for Deep Agents, enabling remote agent execution and monitoring via the ACP specification. Currently at version 0.0.6, pre-release stage with rapid iteration.

pip install deepagents-acp

Common errors

error ModuleNotFoundError: No module named 'deepagents_acp' ↓

cause Package not installed or installed in wrong environment.

fix

Run pip install deepagents-acp and ensure you are in the same Python environment.

error pydantic.error_wrappers.ValidationError: 1 validation error for ACPAgent name field required (type=value_error.missing) ↓

cause ACPAgent requires a 'name' field when created directly; likely attempted to create an ACPAgent without providing required metadata.

fix

Use ACPClient.create_agent(name='my_agent', ...) or ensure all required fields are provided.

error httpx.ConnectError: [Errno 111] Connection refused ↓

cause ACP server is not running or unreachable at the specified URL.

fix

Start the ACP server (e.g., using deepagents acp start) and verify the base_url matches the server address.

Warnings

gotcha ACPClient.run() does not support streaming responses in current version; use .run_stream() for streaming. ↓

fix Use client.run_stream(agent, input) to receive streaming events.

breaking The ACP protocol version is tightly coupled to deepagents version; mismatched versions cause connection errors. ↓

fix Ensure deepagents and deepagents-acp are installed from the same release (e.g., both 0.5.8+).

deprecated The old `from deepagents_acp.server import ACP` import path is deprecated and will be removed in v0.1.0. ↓

fix Use `from deepagents_acp import ACPServer` instead.

Imports

ACPServer
```
from deepagents_acp import ACPServer
```
Correct import for the ACP server class
ACPClient
```
from deepagents_acp import ACPClient
```
Used to connect to remote ACP agents

ACPAgent

wrong

from deepagents_acp.agent import ACPAgent

correct

from deepagents_acp import ACPAgent

ACPAgent is exported at top level, not in submodule

Quickstart

Basic usage: define an agent and execute it via ACP client.

import os
from deepagents import Agent
from deepagents_acp import ACPClient

# Create an agent (e.g., using OpenAI)
agent = Agent(
    name="my-agent",
    instructions="You are a helpful assistant.",
    model="openai/gpt-4o"
)

# Connect to a remote ACP server
client = ACPClient(base_url=os.environ.get("ACP_SERVER_URL", "http://localhost:8000"))

# Execute a task
result = client.run(agent=agent, input="Hello, world!")
print(result)