BlackBean

基于 Go（Gin）的多轮对话 AI Agent， 具有对话式 Web 界面，可通过真实工具（Shell、文件、Python、Docker、协作容器）自主完成复杂任务。

核心特性

• 多轮工具调用：run_bash / read_file / write_file / run_python / list_directory
• Docker 操作：docker_ps / docker_exec / docker_start 等，支持远程 Docker Socket
• 协作任务：run_coop 调起独立协作容器（pi / pigo / claude 三种引擎），异步完成大型任务
• 流式输出：SSE 逐 token 输出，超长上下文自动压缩
• 多协议 LLM：OpenAI / Anthropic 兼容接口，Web 界面可切换模型与密钥

快速开始

go run .

打开 http://localhost:8080 ，在 Web 设置中填入 API Key 即可使用。

部署

支持三种方式：本地运行、Docker 协作引擎、Tsecbench 托管镜像。

详细步骤见 DEPLOY.md（含全部环境变量说明、镜像构建、托管模式与排障）。

目录结构

路径	说明
main.go / internal/	Go 控制层（Agent 核心 + HTTP/WS 服务）
web/static/	前端静态资源
pi-coop/	pi 协作引擎运行时（默认引擎）
pigo/	pigo 协作引擎（Go 实现）
claude code/	Claude Code 协作引擎
tencent/	Tsecbench 托管模式镜像构建

安全提醒

本程序具备命令执行与 Docker 操作能力，云端部署务必设置 AGENT_AUTH_CODE 授权码；API Key 通过环境变量注入，切勿提交到仓库。