跳到主要内容

从源码启动

目标：用一个启动文件，在这台电脑上同时运行 Hub、浏览器管理端和桌面客户端。

开始前：安装 Python 3.12 或更新版本和 Node.js 22.19 或更新版本。Windows 安装 Python 时勾选 Add Python to PATH，Node.js 安装时保留默认选项和 npm。装完后关掉旧的终端窗口。

启动器使用自己的 SQLite 数据库，只监听本机，不连接任何外部的 SoduWork 服务。不需要安装数据库、Docker 或 Git，也不需要准备 .env。

1. 获取源码​

下载源码 ZIP 并全部解压，或者克隆仓库：

git clone https://github.com/mdiri-ai/SoduWork
cd SoduWork

请放在自己有写入权限的普通目录里，例如 C:/SoduWork。不要放进系统程序目录，也不要在 ZIP 里直接运行。

2. 启动​

打开包含 README.md、start.py、client 的目录，按系统选择入口：

系统启动方式
Windows双击 start-desktop.cmd
macOS双击 start-desktop.command
Linux 图形桌面在该目录打开终端，运行 sh start.sh --desktop

这几个入口都等同于 python start.py --desktop：启动 Hub 和管理端，同时打开桌面客户端。

3. 设置管理员密码​

第一次启动时，为账号 admin 设置密码，长度 12～128 个字符，再输入一次确认。输入时屏幕上不会显示字符，输完按回车即可。之后的启动不会再要求设置。

4. 等待准备完成​

保持窗口打开。启动器会自动完成以下步骤：

  1. 建立私有 Python 环境，安装依赖；
  2. 构建管理端；
  3. 准备数据库；
  4. 打开桌面客户端。

第一次需要联网，下载依赖可能要几分钟，耗时较长的步骤大约每 15 秒提示一次进度。详细过程写在窗口里打印的 startup.log 路径下。之后的启动会复用已经装好的内容。

确认启动成功​

终端里出现类似下面的内容（地址以实际输出为准）：

SoduWork is ready: http://127.0.0.1:18989
Administrator: admin

然后会打开浏览器和桌面客户端：

  • 浏览器先显示介绍首页，点 进入管理后台 才是登录页面。
  • 两个界面都用 admin 和你刚设置的密码登录。这是本地实例的账号，不需要另外注册。
  • 桌面客户端已经连上这次启动的本地服务，使用单独的配置目录 desktop-profile/，不会覆盖你电脑上已有的 SoduWork 客户端账号和历史。

退出和再次启动​

  • 退出时在启动窗口按 Ctrl+C，等待停止提示。桌面窗口的关闭按钮可能只是收到托盘，需要在托盘里选择"退出"。
  • 下次仍然双击同一个启动文件，用原来的账号密码登录。数据和配置好的模型都会保留。
  • 已经在运行时不要重复启动，使用已经打开的窗口和页面。

其他启动方式​

在源码根目录运行。macOS 和 Linux 把 python 换成 python3，或者使用 sh start.sh。

用途命令
启动 Hub 并打开桌面客户端（与双击入口相同）python start.py --desktop
只启动 Hub 和浏览器管理端python start.py（Windows 也可双击 start.cmd，macOS 双击 start.command）
只检查环境，不安装、不改动文件python start.py --check --desktop
提前下载和构建，暂不启动python start.py --prepare-only --desktop
不自动打开浏览器python start.py --desktop --no-browser
换一个端口python start.py --desktop --port 18990
指定独立的数据目录python start.py --desktop --data-dir "D:/SoduWork-data"

没有图形桌面的 Linux 服务器请用 sh start.sh，只启动 Hub 和管理端。全部选项见命令行参考。

启动器不会读取源码目录里的 .env、数据库、Agent 配置或已有的模型凭据。

下一步​

harness harnesses runtime runtimes 底座
编辑此页