acp-py
Python Agent SDK - 基于 AgentCP 协议的智能体通信库
安装
pip install acp-py
快速开始
# 启动（默认 Web 模式，自动打开浏览器）
acp-py
# 指定种子密码
acp-py -p my_password
# 指定数据目录和端口
acp-py -d ./my-data --port 8080
# 不自动打开浏览器
acp-py --no-browser
# 使用 CLI 交互模式
acp-py --cli
启动后浏览器会自动打开 http://localhost:9528，在 Web 页面中可以创建 Agent、上线、发起会话和收发消息。
CLI 参数
acp-py [选项]
选项:
-d, --data <path> 数据目录 (默认: ./acp-data)
-p, --password <pwd> 种子密码 (默认: agentcp@2025)
-n, --name <name> Agent 名称 (默认: 自动生成)
-t, --target <aid> 目标 Agent AID (CLI 模式下直接发送消息)
--ap <address> AP 地址 (默认: aid.pub)
--port <number> Web 服务端口 (默认: 9528)
--cli 使用 CLI 交互模式 (不启动 Web)
--no-browser 不自动打开浏览器
--debug 启用调试模式
种子密码优先级
环境变量 > CLI 参数 > 默认值
# 通过环境变量设置（推荐用于部署）
export ACP_SEED_PASSWORD=my_password
acp-py
CLI 交互命令
使用 --cli 模式启动后，可以使用以下命令：
| 命令 | 说明 |
|---|---|
/target <aid> |
设置目标 Agent |
/session |
显示当前会话信息 |
/aid |
显示本机 AID |
/help |
显示帮助 |
/quit |
退出 |
| 其他输入 | 发送消息给目标 |
自定义 Agent 开发
from agentcp import AgentCP
# 创建 AgentCP 实例
acp = AgentCP("./data", seed_password="your_password")
# 创建 Agent
aid = acp.create_aid(ap="aid.pub", agent_name="my_agent")
print(f"Agent AID: {aid.id}")
# 注册消息处理器
async def handle_message(data):
print(f"收到消息: {data}")
aid.add_message_handler(handle_message)
# 上线
aid.online()
# 发送消息
session_id = aid.create_session("my_session", "测试会话")
aid.invite_member(session_id, "target_agent.aid.pub")
aid.send_message(session_id, ["target_agent.aid.pub"], "Hello!")
# 保持运行
acp.serve_forever()
调度器环境变量
以下环境变量用于调整消息调度器的并发参数（可选）：
AGENTCP_SCHED_CORE_WORKERS— 核心线程数（常驻）AGENTCP_SCHED_MAX_WORKERS— 最大线程数（高峰扩展）AGENTCP_SCHED_MAX_TASKS_PER_WORKER— 每线程最大并发异步任务数
系统要求
- Python >= 3.8
- macOS / Linux / Windows
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for acp-py 1.0.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| acp_py-1.0.14.tar.gz | 2.2 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| acp_py-1.0.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.5 MB
Release files / acp_py-1.0.14.tar.gz
| Download URL | acp_py-1.0.14.tar.gz |
|---|---|
| Size | 2.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
503a8255214554ada0e94d638e125b812cee64651bfbb2c0b353c163f30a6874
|
|
BLAKE2b-256 checksum How to use checksums |
4ece33f264571f9c12d3643ed7c96d27c6ee6fb06186f43e7ae888ddb016ad8b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / acp_py-1.0.14-py3-none-any.whl
| Download URL | acp_py-1.0.14-py3-none-any.whl |
|---|---|
| Size | 2.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df454c77bef5397c2db7bab31355b173a9c6f819a1f227993beb2dd654f561c3
|
|
BLAKE2b-256 checksum How to use checksums |
c7d037c597cb236e6cfe501a7c20ec1aee18cacdf652bdf347ec191f71a516ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Security for acp-py 1.0.14
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
