本地部署 🔧

字数

1111 字

阅读

6 分钟

本地部署运行

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

配置要求

操作系统： 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.26     -> 1.0.26
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

🚀 Starting service... http://0.0.0.0:8000

Tools
uv 0.9.5        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:/Program Files/CreatorBox/ffmpeg/ffmpeg.EXE
ffprobe 8.0     Using D:/Program Files/CreatorBox/ffmpeg/ffprobe.EXE
git 2.51.0      Using D:/Program Files/CreatorBox/git/cmd/git.EXE

Environment
PATH:
  01. D:\Program Files\CreatorBox\creatorbox\.venv\Lib\site-packages\cv2\../../x64/vc14/bin
  02. D:\Program Files\CreatorBox\creatorbox\.venv\Scripts
  03.
  04. D:\Program Files\CreatorBox
  05. D:\Program Files\CreatorBox\aria2
  06. D:\Program Files\CreatorBox\ffmpeg
  07. D:\Program Files\CreatorBox\git\cmd
  08. D:\Program Files\CreatorBox\uv
  09. C:\Windows\system32
  10.

CreatorBox
          CREATORBOX_HOME: D:\Program Files\CreatorBox
         CREATORBOX_MODEL:

ThirdParty
           OPENAI_API_KEY:
           GEMINI_API_KEY:
            AZURE_API_KEY:
       ELEVENLABS_API_KEY:
 HUGGINGFACEHUB_API_TOKEN:

Network
               HTTP_PROXY:
              HF_ENDPOINT: https://hf-mirror.com

Models
    HUGGINGFACE_HUB_CACHE: D:\Program Files\CreatorBox\creatorbox\models\huggingface\hub
         MODELSCOPE_CACHE: D:\Program Files\CreatorBox\creatorbox\models\modelscope\hub
               TORCH_HOME: D:\Program Files\CreatorBox\creatorbox\models\torch

Uv
           UV_INSTALL_DIR: D:\Program Files\CreatorBox\uv
             UV_CACHE_DIR: D:\Program Files\CreatorBox\uv\cache
        UV_PYTHON_BIN_DIR: D:\Program Files\CreatorBox\uv
    UV_PYTHON_INSTALL_DIR: D:\Program Files\CreatorBox\uv\python
          UV_TOOL_BIN_DIR: D:\Program Files\CreatorBox\uv
              UV_TOOL_DIR: D:\Program Files\CreatorBox\uv\tool
         UV_DEFAULT_INDEX: https://pypi.tuna.tsinghua.edu.cn/simple

System
                     TEMP: C:\Users\ADMINI~1\AppData\Local\Temp
   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.26.f83bdbff

2025-11-27 16:04:54.355 | INFO  2616  main.py:113 - Build on master at 2025-11-26 21:21:28 started run successfully (5.98 seconds)
2025-11-27 16:04:54.356 | INFO  2616  main.py:124 - Running on CPU device using Windows OS located in CN.
2025-11-27 16:04:54.356 | INFO  2616  main.py:126 - Running with Python 3.11.11 and Torch 2.6.0+cpu.
2025-11-27 16:04:54.357 | INFO  2616  main.py:128 - Startup 7 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

3. 安装依赖

bash

uv venv --python 3.11.11

bash

uv sync --all-groups

4. 启动运行

bash

uv run cli.py start

注意

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

bash

git pull

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

bash

uv run cli.py start

Windows 直接双击 start.bat 或 桌面快捷方式图标 运行

访问界面

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

log

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

2025-11-27 16:04:54.355 | INFO  2616  main.py:113 - Build on master at 2025-11-26 21:21:28 started run successfully (5.98 seconds)
2025-11-27 16:04:54.356 | INFO  2616  main.py:124 - Running on CPU device using Windows OS located in CN.
2025-11-27 16:04:54.356 | INFO  2616  main.py:126 - Running with Python 3.11.11 and Torch 2.6.0+cpu.
2025-11-27 16:04:54.357 | INFO  2616  main.py:128 - Startup 7 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. 启动运行

访问界面

终端命令