connectonion

环境要求

• 已安装 Python 与 pip（README 未指定具体版本）
• 可访问 PyPI 以安装 connectonion
• 如需自选 Gemini 模型，需准备 GEMINI_API_KEY
• 可执行 python 与 co 命令的终端环境

安装与启动步骤

1. 1安装框架

   用 pip 从 PyPI 安装 connectonion，装好后同时获得 Python 库和 co 命令行工具。

   pip install connectonion

   复制

2. 2创建 Agent

   co create 会生成一个可直接运行的 Agent 模板，自带文件、Shell、浏览器、规划、待办和子 Agent 能力。

   co create sales-agent

   复制

3. 3进入项目目录

   切换到刚生成的项目目录，后续 co 命令都在该目录内执行。

   cd sales-agent

   复制

4. 4启动 Agent

   co ai 在项目内启动 Agent，可在终端或 Web 客户端里对话；CLI 会自动引导完成 API key 设置。

   co ai

   复制

5. 5健康检查

   co doctor 诊断环境与运行问题，告诉你当前什么在运行、哪些需要处理。

   co doctor

   复制

6. 6Python 方式运行

   已有 Agent 项目时，可进入项目目录直接运行 agent.py；也可调用 host(agent) 以 HTTP + P2P 中继自托管。

   python agent.py

   复制

7. 7部署 Agent

   co deploy 把写好的 Agent 发布出去，交给托管环境运行。

   co deploy

   复制

8. 8查看状态

   co status 显示 Agent 当前运行与部署状态，便于排查是否正常。

   co status

   复制

关键配置

如何确认成功

执行 co status 或 co doctor 能正常输出运行状态与诊断结果，且 python agent.py 无报错启动，即表示可用。

常见问题

注意事项

• README 未给出 Python 版本、端口号与具体路径要求，请以实际环境和 co doctor 输出为准。
• co create 生成的模板已内置文件、Shell、浏览器、规划、待办和子 Agent 能力，可直接扩展。
• 除 co deploy 托管外，ConnectOnion 的 Python 运行时仍可直接使用，便于自定义工具、钩子、Provider 或宿主边界。