本地部署 🔧

字数

1213 字

阅读

7 分钟

本地部署运行

只是想尝试一下？见《远程部署》章节

配置要求

操作系统： Windows10+ 、 Macos11+ 、 Debian12+ 系统
支持架构： windows.x86_64 、 linux.x86_64 、 darwin_x86_64
建议最低 CPU 4核 或以上，内存 8G 或以上，GPU 非必须，支持 cpu 或 cuda

前提条件

请确保你的网络是正常的，VPN 需要打开全局模式或者在设置中 启用网络代理
安装不要使用 中文路径，或 空格路径 避免出现一些无法预料的问题

提示

科学上网，见《JustMySocks》章节
环境变量，见《准备工作》章节

集成包

下载

creatorbox_setup_zh

组件选项

选项（完全安装、简洁安装、自定义安装）

creatorbox_setup_components_zh

log

   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\

Selected Components: Basic

SUCCESS: Specified value was saved.

;D:\Program Files\CreatorBox;D:\Program Files\CreatorBox\aria2;D:\Program Files\CreatorBox\ffmpeg;D:\Program Files\CreatorBox\git\cmd;D:\Program Files\CreatorBox\uv;"C:\Windows\system32";

========================================== Git ==========================================
git version 2.51.0.windows.2
Git LFS initialized.
git-lfs/3.7.0 (GitHub; windows amd64; go 1.24.4; git 92dddf56)
项目 "creatorbox" 已存在，开始更新...
HEAD is now at b1d726f sd 开启代理无法打开页面
remote: Enumerating objects: 6, done.
remote: Counting objects: 100% (6/6), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 6 (delta 3), reused 6 (delta 3), pack-reused 0 (from 0)
Unpacking objects: 100% (6/6), 504 bytes | 33.00 KiB/s, done.
From https://github.com/xiesx123/CreatorBox
   b1d726f..a45e167  master     -> origin/master
 * [new tag]         1.0.30     -> 1.0.30
Updating b1d726f..a45e167
Fast-forward
 webapp/data/plugins.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

========================================== Aria2 ========================================
aria2 version 1.37.0

========================================== FFmpeg ========================================
ffmpeg version 8.0-essentials_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers
ffprobe version 8.0-essentials_build-www.gyan.dev Copyright (c) 2007-2025 the FFmpeg developers

========================================== Uv ========================================
uv 0.9.5 (d5f39331a 2025-10-21)

⚙️ 正在设置用户环境变量 ...

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.

SUCCESS: Specified value was saved.
✅ 基础环境变量设置完成

➕ 正在将 UV_INSTALL_DIR 添加到 PATH
原始 PATH 长度: %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbe...
⚠️ PATH 已包含 D:\Program Files\CreatorBox\uv，跳过添加

📋 可安装的 Python 版本
cpython-3.15.0a1-windows-x86_64-none                 <download available>
cpython-3.15.0a1+freethreaded-windows-x86_64-none    <download available>
cpython-3.14.0-windows-x86_64-none                   <download available>
cpython-3.14.0+freethreaded-windows-x86_64-none      <download available>
cpython-3.13.9-windows-x86_64-none                   <download available>
cpython-3.13.9+freethreaded-windows-x86_64-none      <download available>
cpython-3.12.12-windows-x86_64-none                  <download available>
cpython-3.11.14-windows-x86_64-none                  <download available>
cpython-3.11.11-windows-x86_64-none                  uv\python3.11.exe
cpython-3.11.11-windows-x86_64-none                  uv\python\cpython-3.11.11-windows-x86_64-none\python.exe
cpython-3.10.19-windows-x86_64-none                  uv\python\cpython-3.10.19-windows-x86_64-none\python.exe
cpython-3.10.19-windows-x86_64-none                  <download available>
cpython-3.9.24-windows-x86_64-none                   <download available>
cpython-3.8.20-windows-x86_64-none                   <download available>
pypy-3.11.13-windows-x86_64-none                     <download available>
pypy-3.10.16-windows-x86_64-none                     <download available>
pypy-3.9.19-windows-x86_64-none                      <download available>
pypy-3.8.16-windows-x86_64-none                      <download available>
graalpy-3.12.0-windows-x86_64-none                   <download available>
graalpy-3.11.0-windows-x86_64-none                   <download available>
graalpy-3.10.0-windows-x86_64-none                   <download available>

🐍 正在安装 Python
Installed Python 3.10.19 in 15ms
 + cpython-3.10.19-windows-x86_64-none (python3.10.exe)
Installed Python 3.11.11 in 12ms
 + cpython-3.11.11-windows-x86_64-none (python3.11.exe)
✅ Python 安装完成

============================================ CreatorBox ==================================
Resolved 299 packages in 0.86ms
Audited 277 packages in 3ms

-------------------------------------
⚠️ 所有设置已完成，按任意键关闭当前窗口
-------------------------------------
Press any key to continue . . .

启动模式

选项:（调试、默认）

creatorbox_setup_debug_zh

log

INFO:     Will watch for changes in these directories: ['D:\\Program Files\\CreatorBox\\creatorbox']
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [14260] using StatReload
2026-03-09 16:54:45.809 | INFO  11500 tlog.py:148 - [StartupTimer] D:/Program Files/CreatorBox/creatorbox/src/main.py:45: +4182.04 ms (total 4182.04 ms)
uv 0.10.7       Using D:/Program Files/CreatorBox/uv/uv.EXE
Python 3.11.11  Using D:/Program Files/CreatorBox/creatorbox/.venv/Scripts/python.EXE
ffmpeg 8.0      Using D:/Develop Files/CreatorBox/ffmpeg/bin/ffmpeg.EXE
ffprobe 8.0     Using D:/Develop Files/CreatorBox/ffmpeg/bin/ffprobe.EXE
git 2.51.0      Using D:/Develop Files/CreatorBox/git/cmd/git.EXE
aria2 1.37.0    Using D:/Program Files/CreatorBox/aria2/aria2c.EXE
2026-03-09 16:54:45.931 | INFO  11500 cbrequest.py:302 - Use system proxy.
2026-03-09 16:54:45.932 | INFO  11500 tlog.py:148 - [StartupTimer] D:/Program Files/CreatorBox/creatorbox/src/main.py:188: +0122.74 ms (total 4304.77 ms)
/dashboard   | +0428.59 ms | total 0428.59 ms
/settings    | +2681.82 ms | total 3110.41 ms
/login       | +0333.76 ms | total 3444.17 ms
/dh          | +0668.35 ms | total 4112.52 ms
/asr         | +2015.21 ms | total 6127.73 ms
/scs         | +0370.89 ms | total 6498.63 ms
/dlp         | +0599.15 ms | total 7097.78 ms
/vmi         | +2467.63 ms | total 9565.41 ms
/vse         | +0741.84 ms | total 10307.25 ms
/vsd         | +0509.84 ms | total 10817.09 ms
/uvr         | +0382.95 ms | total 11200.04 ms
/sdr         | +0361.41 ms | total 11561.45 ms
2026-03-09 16:54:57.496 | INFO  11500 tlog.py:148 - [StartupTimer] D:/Program Files/CreatorBox/creatorbox/src/main.py:194: +11563.88 ms (total 15868.66 ms)
   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.30.7d765e86

2026-03-09 16:54:57.500 | INFO  11500 main.py:105 - Build on master at 2026-03-08 18:55:36 started run Debug successfully (15.87 seconds)
2026-03-09 16:54:58.145 | INFO  11500 main.py:120 - Running on CUDA device using Windows OS located in CN.
2026-03-09 16:54:58.145 | INFO  11500 main.py:122 - Running with Python 3.11.11 and Torch 2.6.0+cu126 OnnxRuntime 1.23.2+gpu.
2026-03-09 16:54:58.146 | INFO  11500 main.py:124 - Startup 11 app completed.
2025-11-27 16:04:54.358 | INFO  2616  main.py:129 - http://127.0.0.1:8000

注意

如果启动失败，进入安装目录，手动再次执行 setup.bat，查看控制台是否报错

手动安装

1. 安装 uv

bash

pip install -U uv

2. 克隆下载

bash

git clone https://github.com/xiesx123/CreatorBox.git && cd CreatorBox

Lfs

bash

git lfs install
git lfs pull

扩展

bash

# iopaint
git submodule update --init --remote --depth=1 extensions/iopaint

可选

bash

# stable_diffusion_webui
git submodule update --init --remote --depth=1 extensions/stable_diffusion_webui
# cosyvoice
git submodule update --init --remote --depth=1 extensions/cosyvoice
# index_tts
git submodule update --init --remote --depth=1 extensions/index_tts
# gpt_sovits
git submodule update --init --remote --depth=1 extensions/gpt_sovits
# voxcpm
git submodule update --init --remote --depth=1 extensions/voxcpm

3. 安装依赖

bash

uv venv --python 3.11.11

bash

uv sync --extra cpu

bash

uv sync --extra gpu

4. 启动运行

bash

uv run --extra cpu cli.py start

bash

uv run --extra gpu cli.py start

注意

启动报错 RuntimeError: this license key is expired，请尝试远程更新

bash

git pull

启动报错 RuntimeError: [WinError 10060]...(1:11076)，请尝试重新启动

bash

uv run --extra {gpu|cpu} cli.py start

Windows 直接双击 start.bat 或 桌面快捷方式 运行，请根据实际配置调整环境

creatorbox/start.bat

bash

REM Execute script
set SCRIPT_CMD=uv run --extra gpu
set SCRIPT_PATH=cli.py
set SCRIPT_ARGS=start -h 0.0.0.0 -p 8000
if "%~1"=="--debug" (
    set SCRIPT_ARGS=%SCRIPT_ARGS% --debug
)

默认使用 cpu 运行，使用 gpu 需添加 --extra gpu 参数

访问界面

本机访问 http://127.0.0.1:8000
内网访问 http://172.18.0.1:8000 以实际为准 👇

log

🚀 Starting service... http://127.0.0.1:8000
   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.30.7d765e86

2026-03-09 16:54:57.500 | INFO  11500 main.py:105 - Build on master at 2026-03-08 18:55:36 started run Debug successfully (15.87 seconds)
2026-03-09 16:54:58.145 | INFO  11500 main.py:120 - Running on CUDA device using Windows OS located in CN.
2026-03-09 16:54:58.145 | INFO  11500 main.py:122 - Running with Python 3.11.11 and Torch 2.6.0+cu126 OnnxRuntime 1.23.2+gpu.
2026-03-09 16:54:58.146 | INFO  11500 main.py:124 - Startup 11 app completed.
2025-11-27 16:04:54.358 | INFO  2616  main.py:129 - http://127.0.0.1:8000

终端命令

更多命令行工具，见《终端命令》章节

本地部署 🔧 ​

配置要求 ​

前提条件 ​

集成包 ​

组件选项 ​

启动模式 ​

手动安装 ​

1. 安装 uv ​

2. 克隆下载 ​

3. 安装依赖 ​

4. 启动运行 ​

访问界面 ​

终端命令 ​

本地部署 🔧

配置要求

前提条件

集成包

组件选项

启动模式

手动安装

1. 安装 uv

2. 克隆下载

3. 安装依赖

4. 启动运行

访问界面

终端命令