首页 / 文档 / 快速开始 / 一键安装

一键安装

使用脚本一键安装和管理 通千算智

先选一种方式

通千算智 有三种使用方式,先选一条路再往下看:

方式 适合谁 入口
桌面客户端(Windows 绿色免安装) 想立刻用、需要操作本机文件 下载页 · 使用说明
团队工作台(浏览器,免部署) 团队协作、共享知识库 团队工作台
服务器部署(本文以下内容) 要 7×24 运行、私有化、可开发 继续往下读

桌面客户端已内置运行环境,不需要你安装 Python 或任何依赖; 本文以下部分是「源码 / 脚本部署」的说明,适合开发者和服务器运维。

脚本一键安装

项目提供了一键安装、配置、启动、管理程序的脚本,推荐使用脚本快速运行。

支持 Linux、macOS、Windows 操作系统,需安装 Python 3.7 ~ 3.13(推荐 3.9)。

安装命令

脚本自动执行以下流程:

  1. 检查 Python 环境(需要 Python 3.7+)
  2. 安装必要工具(git、curl 等)
  3. 克隆项目代码到 ~/通千算智
  4. 安装 Python 依赖和 通千算智 CLI
  5. 引导配置 AI 模型和通信渠道
  6. 启动服务

运行后默认启动 Web 控制台,访问 http://localhost:9899 开始对话和管理Agent。

服务器部署需要公网访问控制台时,请在 config.json 中将 web_host 设为 0.0.0.0(默认仅监听 127.0.0.1 本机访问),同时强烈建议设置 web_password 启用鉴权。然后通过 http://<server-ip>:9899 访问,并确保防火墙/安全组放行 9899 端口。

管理命令

安装完成后,使用 cow CLI 管理服务:

命令 说明
cow start 启动服务
cow stop 停止服务
cow restart 重启服务
cow status 查看运行状态
cow logs 查看实时日志
cow update 更新代码并重启
cow install-browser 安装浏览器工具依赖

更多命令和用法参考 命令文档。

如果 cow 命令不可用,也可以使用 ./run.sh <命令>(Linux/macOS)或 .\scripts\run.ps1 <命令>(Windows)作为替代,功能等效。