BettaFish 多智能体系统 Docker 部署指南
介绍 BettaFish 多智能体系统的 Docker 部署流程。主要步骤包括从 GitHub 克隆项目,修改 docker-compose.yml 端口及镜像源,配置 .env 文件中的数据库与大模型 API 密钥(如 Qwen、Gemini 等),以及网络搜索工具接口。完成配置后通过 docker compose 启动服务,访问本地端口进行功能测试。需注意部分大模型服务需付费,建议按需充值。

介绍 BettaFish 多智能体系统的 Docker 部署流程。主要步骤包括从 GitHub 克隆项目,修改 docker-compose.yml 端口及镜像源,配置 .env 文件中的数据库与大模型 API 密钥(如 Qwen、Gemini 等),以及网络搜索工具接口。完成配置后通过 docker compose 启动服务,访问本地端口进行功能测试。需注意部分大模型服务需付费,建议按需充值。

打开项目 GitHub 仓库。如果网络受限,建议下载 ZIP 压缩包并解压。
具体操作如下:
git clone https://github.com/666ghj/BettaFish.git。



找到 docker-compose.yml 文件,然后打开。



cp .env.example .env。

数据库使用 Docker 提供的容器,无需本地安装。配置如下:
# ====================== 数据库配置 ======================
# 数据库主机,例如 localhost 或 127.0.0.1
DB_HOST=db
# 数据库端口号,默认为 3306
DB_PORT=5432
# 数据库用户名
DB_USER=bettafish
# 数据库密码
DB_PASSWORD=bettafish
# 数据库名称
DB_NAME=bettafish
# 数据库字符集,推荐 utf8mb4,兼容 emoji
DB_CHARSET=utf8mb4
# 数据库类型 mysql 或 postgresql
DB_DIALECT=postgresql

这是最重要和最容易出错的一步。项目支持多种大模型,主要包括:
网络搜索工具:
推荐使用云服务配置除 Gemini-2.5-pro 的大模型。Gemini-2.5-pro 需单独配置。
打开 .env 文件,填写 API_KEY 和 URL。
API_KEY 填写复制下来的密钥,URL 填写 https://yunwu.ai/v1。
模型名称在备注里有说明,直接复制粘贴即可。注意不要为 Gemini-2.5-pro 填写此配置。

配置完成后点击提交,将密钥复制下来。

配置只需要对两处进行配置,分别是名称和额度设置,其他的不用处理。

然后打开 API 令牌,创建令牌。

适当充值,建议充值适量金额。

通过 GitHub 或其他登录方式进入控制台,打开钱包。

注意,上述服务不要配置 Gemini-2.5-pro 的大模型。
回到密钥处,如果没有默认密钥请创建一个,之后将 API-key 复制下来,粘贴到 VSCode 里。

先去注册,然后打开上侧的密钥,进行充值,建议充值适量金额。

打开推理时代网站:

最后给两个网络搜索的工具配置 API。
Tavily API 密钥只需要登陆注册就可以。 Bocha Web 在登陆进去有一个免费资源包,申请 api key 然后复制粘贴到 vscode 里的.env 文件。

URL 就跟我填写一样的就好,然后就是记住不要填错 API 喔。
完成上面的 API 配置后,可以直接实战测试。
localhost:5050。
回到 VSCode 里,在终端输入指令 docker compose up -d。

如果你打开了上面的界面,那就恭喜你完成了配置,下面你就可以保存并启动系统了!
然后你可以输入一个主题,比如在这里输入'研究近 3 年的中国民办本科大学生毕业的就业率情况'。
输入后点击搜索,然后去每一个 agent 里看看他们有没有报错,如果没有那就恭喜了!你获得了一个八卦助手!

如果有任何的问题,可以在社区或文档中查找帮助。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online