跳到主要内容

安装与启动

CountBot 支持源码运行，也支持桌面模式。大多数用户先把服务跑起来，再进入 Web 界面完成模型、工作空间和渠道配置。

环境要求​

运行 CountBot​

  • Python 3.11+
  • Windows、macOS 或 Linux
  • 能访问你准备接入的模型服务

构建前端或文档​

  • Node.js 18+

方式一：源码运行​

1. 获取代码​

git clone https://github.com/countbot-ai/countbot.git
cd countbot

2. 安装依赖​

pip install -r requirements.txt

如果你在国内环境中安装较慢，可以改用镜像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

3. 启动服务​

python start_app.py

默认访问地址：

http://127.0.0.1:8000

如果你需要指定端口：

$env:PORT=9000
python start_app.py

方式二：桌面模式​

如果你希望更快体验完整界面，也可以直接使用桌面模式或桌面打包产物。

适合场景：

  • 不想手动配置 Python 环境
  • 主要在本机使用图形界面
  • 想快速验证聊天、团队、渠道和编程工具配置

桌面模式仍然会启动同一套后端服务，只是以前端容器的形式运行。

首次进入后的建议顺序​

1. 配置模型​

在设置页完成：

  • 默认提供商
  • API Key
  • 默认模型
  • 温度、最大输出等运行参数

2. 确认工作空间​

工作空间会承载：

  • 技能目录
  • 记忆文件
  • 临时文件与截图
  • 运行中的业务产物
  • 外部编程工具配置文件

3. 设置人格与默认行为​

建议先补齐：

  • AI 名称
  • 用户称呼
  • 输出语言
  • 默认人格

4. 再配置团队、渠道和编程工具​

推荐顺序：

  1. 先把默认模型和工作空间配稳定
  2. 再配置团队和角色
  3. 再接入渠道账号
  4. 最后决定是否给某些渠道账号接入外部编程工具

启动后自检清单​

  • Web 页面能正常打开
  • 设置页能读取并保存模型配置
  • 聊天页能完成一次基础问答
  • 工作空间路径可读可写
  • 如需外部渠道，渠道测试接口可以通过

下一步​