本地部署 🔧

字数

890 字

阅读

5 分钟

本地部署运行

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

配置要求

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

前提条件

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

提示

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

集成包

下载

✅ 整合包（Windows）一键本地安装、更新、运行
✅ 内置集成环境（Python、FFmpeg、Git）无需额外安装
✅ 兼容不同环境（ Conda 、Builtin、Custom）下的Py环境

setup_zh

组件选项

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

setup_zh

log

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

Selected Components: Basic,Elevenlabs,CosyVoice2,GPTSoVITS
...
📦 Installing from src/support/third_party/elevenlabs/requirements.txt
...
📦 Installing from src/support/third_party/cosyvoice/requirements.txt
...
📦 Installing from src/support/third_party/gptsovits/requirements.txt
...
📦 Installing from requirements.txt
...
...
Press any key to continue . . .

启动模式

选项:（调试、默认）

setup_zh

log

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

Tools
Python 3.11.9   Using D:\Program Files\CreatorBox\python\python.EXE
pip 25.2        Using D:\Program Files\CreatorBox\python\Scripts\pip.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\python\Lib\site-packages\cv2\../../x64/vc14/bin
  02.
  03. D:\Program Files\CreatorBox
  04. D:\Program Files\CreatorBox\python
  05. D:\Program Files\CreatorBox\python\Scripts
  06. D:\Program Files\CreatorBox\ffmpeg
  07. D:\Program Files\CreatorBox\git\cmd
  08. D:\miniconda3
  09. D:\miniconda3\condabin
  10. "C:\Windows\system32"
  11.

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

ThirdParty
           OPENAI_API_KEY: xxxx
           GOOGLE_API_KEY: xxxx
            AZURE_API_KEY: xxxx
       ELEVENLABS_API_KEY: xxxx
 HUGGINGFACEHUB_API_TOKEN: xxxx

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
     MODELSCOPE_LOG_LEVEL: 40
               TORCH_HOME: D:\Program Files\CreatorBox\creatorbox\models\torch

System
                     TEMP: C:\Users\xiesx\AppData\Local\Temp

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

2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:161 - Build on master at 2025-10-02 18:55:25 started run Debug successfully (9.44 seconds)
2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:169 - Running on CPU device using Windows OS located in US.
2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:171 - Running with Python 3.11.9 and Torch 2.6.0+cpu.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:176 - Startup 2 job completed.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:177 - Startup 0 app completed.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:178 - http://172.18.0.1:8000

注意

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

手动安装

1. 克隆下载

bash

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

2. 虚拟环境

创建虚拟环境

bash

conda create --name creatorbox python=3.11.11

激活虚拟环境

bash

conda activate creatorbox

3. 安装依赖

可选

bash

# elevenlabs
python cli.py install -f src/support/third_party/elevenlabs/requirements.txt
# cosyvoice
python cli.py install -f src/support/third_party/cosyvoice/requirements.txt
# gptsovits
python cli.py install -f src/support/third_party/gptsovits/requirements.txt

必须

bash

python cli.py install -f requirements.txt

4. 启动运行

bash

python cli.py start

注意

安装依赖时 需按顺序执行，先执行可选项，在执行必须项
如果下载很慢，需要修改镜像源

pip

bash

pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
pip config list

conda

bash

conda config --add channels conda-forge
conda config --show channels

注意

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

bash

python cli.py update --force

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

bash

python cli.py start

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

终端命令

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

访问界面

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

log

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

2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:161 - Build on master at 2025-10-02 18:55:25 started run successfully (9.44 seconds)
2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:169 - Running on CPU device using Windows OS located in US.
2025-10-04 15:29:42.302 | INFO  13224 <frozen src.main>:171 - Running with Python 3.11.9 and Torch 2.6.0+cpu.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:176 - Startup 2 job completed.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:177 - Startup 0 app completed.
2025-10-04 15:29:42.303 | INFO  13224 <frozen src.main>:178 - http://172.18.0.1:8000

偏好设置

访问 http://127.0.0.1:8000/settings

基础设置	草稿设置	其他设置

本地部署 🔧 ​

配置要求 ​

前提条件 ​

集成包 ​

组件选项 ​

启动模式 ​

手动安装 ​

1. 克隆下载 ​

2. 虚拟环境 ​

3. 安装依赖 ​

4. 启动运行 ​

终端命令 ​

访问界面 ​

偏好设置 ​

本地部署 🔧

配置要求

前提条件

集成包

组件选项

启动模式

手动安装

1. 克隆下载

2. 虚拟环境

3. 安装依赖

4. 启动运行

终端命令

访问界面

偏好设置