本地部署 🔧

字数

447 字

阅读时间

3 分钟

本地部署运行

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

配置要求

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

前提条件

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

提示

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

安装步骤

1. 克隆下载

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

2. 虚拟环境

• 创建虚拟环境

conda create --name creatorbox python=3.11.11

• 激活虚拟环境

conda activate creatorbox

3. 安装依赖

可选

# 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
# f5_tts
python cli.py install -f src/support/third_party/f5_tts/requirements.txt
# coqui_tts
python cli.py install -f src/support/third_party/coqui_tts/requirements.txt

必须

python cli.py install -f requirements.txt

4. 启动运行

python cli.py start

注意

• 安装依赖时 需按顺序执行，先执行可选项，在执行必须项

• 如果下载很慢，需要修改镜像源

pip

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

conda config --add channels conda-forge
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/msys2/
conda config --show channels

注意

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

python cli.py update --force

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

python cli.py start

• Windows 直接双击 start.bat 运行

终端命令

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

访问界面

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

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

2025-08-23 18:51:07.416 | INFO  2612  main.py:127 - Build on master at 2025-08-23 18:42:57 started run successfully (8.02 seconds)
2025-08-23 18:51:08.322 | INFO  2612  proxy.py:91 - Proxy enabled and verified successfully.
2025-08-23 18:51:10.059 | INFO  2612  main.py:137 - Running on cpu device using Windows OS located in us.
2025-08-23 18:51:10.060 | INFO  2612  main.py:141 - Startup 2 job completed.
2025-08-23 18:51:10.060 | INFO  2612  main.py:142 - Startup 0 app completed.
2025-08-23 18:51:10.062 | INFO  2612  main.py:143 - http://172.18.0.1:8000

偏好设置

• 访问 http://127.0.0.1:8000/settings

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