Local Deployment

Word count

1095 words

Reading time

7 minutes

Run locally

Just want to try it out? Jump to the 《Remote Deployment》 section

Requirements

Operating System: Windows10+, Macos11+, Debian12+
Supported Architectures: windows.x86_64, linux.x86_64, darwin_x86_64

Note

Do not use paths with spaces to avoid unexpected issues
Ensure your network is working properly. If downloads fail, enable VPN global mode
The environment will be automatically downloaded and configured during installation, no manual intervention required
Model files are downloaded on demand, only downloaded when actually used
In some cases, you need to configure 《environment variables》

Integrated Package

Recommended to download Integrated Installation Package with built-in integrated environment, no additional configuration needed 🔥🔥🔥🔥🔥

creatorbox_setup_en

Component Options

Options: (Full, Compact, Custom)

creatorbox_setup_components_en

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.31     -> 1.0.31
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 . . .

Startup Mode

Options: (Debug, Normal)

creatorbox_setup_debug_en

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.31.ed122ee

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

Note

If the startup fails, navigate to the installation directory and manually execute setup.bat. Check the console for any error messages.
If the download or update fails, you can manually repeat the setup.bat command to update the software package with one click.

Manual Installation

1. Clone repository

bash

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

Lfs

bash

git lfs install
git lfs pull

Extensions

bash

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

# 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

2. Install dependencies

bash

powershell -c "irm https://astral.sh/uv/install.ps1 | more"

bash

uv venv --python 3.11.11

bash

uv sync --extra cpu
# or
uv sync --extra gpu

3. Start and Run

bash

uv run --extra cpu cli.py start
#or
uv run --extra gpu cli.py start

Note

If you see RuntimeError: this license key is expired, try forcing an update:

bash

# git reset --hard
# git clean -fd
git pull

For Windows, simply double-click start.bat or create a desktop shortcut to run it. Please adjust the environment settings according to your actual configuration.

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
)

runs on cpu by default. To use gpu, you need to add the --extra gpu parameter.

Access the Interface

Local access: http://127.0.0.1:8000
Internal access: http://172.18.0.1:8000 (actual address may vary) 👇

log

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

2026-03-09 16:54:57.500 | INFO  11500 main.py:105 - Build on master at 2026-03-08 18:55:36 started run 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

Terminal Commands

For more command-line tools, see the Terminal Commands section.

Local Deployment ​

Requirements ​

Integrated Package ​

Component Options ​

Startup Mode ​

Manual Installation ​

1. Clone repository ​

2. Install dependencies ​

3. Start and Run ​

Access the Interface ​

Terminal Commands ​

Local Deployment

Requirements

Integrated Package

Component Options

Startup Mode

Manual Installation

1. Clone repository

2. Install dependencies

3. Start and Run

Access the Interface

Terminal Commands