{"id":27683,"library":"deepagents-acp","title":"Deep Agents ACP","description":"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.","status":"active","version":"0.0.6","language":"python","source_language":"en","source_url":"https://github.com/langchain-ai/deepagents","tags":["agent-client-protocol","acp","deep-agents","langchain","agent-framework"],"install":[{"cmd":"pip install deepagents-acp","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core Deep Agents framework required for agent definitions and orchestration","package":"deepagents","optional":false},{"reason":"HTTP client for ACP protocol communication","package":"httpx","optional":false},{"reason":"Data validation and settings management","package":"pydantic","optional":false}],"imports":[{"note":"Correct import for the ACP server class","symbol":"ACPServer","correct":"from deepagents_acp import ACPServer"},{"note":"Used to connect to remote ACP agents","symbol":"ACPClient","correct":"from deepagents_acp import ACPClient"},{"note":"ACPAgent is exported at top level, not in submodule","wrong":"from deepagents_acp.agent import ACPAgent","symbol":"ACPAgent","correct":"from deepagents_acp import ACPAgent"}],"quickstart":{"code":"import os\nfrom deepagents import Agent\nfrom deepagents_acp import ACPClient\n\n# Create an agent (e.g., using OpenAI)\nagent = Agent(\n    name=\"my-agent\",\n    instructions=\"You are a helpful assistant.\",\n    model=\"openai/gpt-4o\"\n)\n\n# Connect to a remote ACP server\nclient = ACPClient(base_url=os.environ.get(\"ACP_SERVER_URL\", \"http://localhost:8000\"))\n\n# Execute a task\nresult = client.run(agent=agent, input=\"Hello, world!\")\nprint(result)\n","lang":"python","description":"Basic usage: define an agent and execute it via ACP client."},"warnings":[{"fix":"Use client.run_stream(agent, input) to receive streaming events.","message":"ACPClient.run() does not support streaming responses in current version; use .run_stream() for streaming.","severity":"gotcha","affected_versions":"<=0.0.6"},{"fix":"Ensure deepagents and deepagents-acp are installed from the same release (e.g., both 0.5.8+).","message":"The ACP protocol version is tightly coupled to deepagents version; mismatched versions cause connection errors.","severity":"breaking","affected_versions":"all"},{"fix":"Use `from deepagents_acp import ACPServer` instead.","message":"The old `from deepagents_acp.server import ACP` import path is deprecated and will be removed in v0.1.0.","severity":"deprecated","affected_versions":">=0.0.4, <0.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install deepagents-acp` and ensure you are in the same Python environment.","cause":"Package not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'deepagents_acp'"},{"fix":"Use `ACPClient.create_agent(name='my_agent', ...)` or ensure all required fields are provided.","cause":"ACPAgent requires a 'name' field when created directly; likely attempted to create an ACPAgent without providing required metadata.","error":"pydantic.error_wrappers.ValidationError: 1 validation error for ACPAgent\nname\n  field required (type=value_error.missing)"},{"fix":"Start the ACP server (e.g., using `deepagents acp start`) and verify the base_url matches the server address.","cause":"ACP server is not running or unreachable at the specified URL.","error":"httpx.ConnectError: [Errno 111] Connection refused"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}