Local Deployment 🔧

Word count

342 words

Reading time

3 minutes

Run locally

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

Requirements

• Operating System: Windows10+, Macos11+, Debian12+
• Supported Architectures: windows.x86_64, linux.x86_64, darwin_x86_64
• Recommended Minimum: CPU 4 cores or more, Memory 8GB or more, GPU is optional, supports cpu or cuda

Prerequisites

• Please make sure your network is functioning properly. Your VPN should be set to Global Mode or have Enable Network Proxy turned on in the settings.
• Do not install Conda in Chinese paths or paths with spaces to avoid unexpected issues

TIP

• For scientific internet access, see the 《JustMySocks》 section.
• For virtual environment setup, see the 《Preparation》 section.

Automatic Installation

Download, install, and deploy through the integrated installation package. Still organizing and testing…

Manual Installation

1. Clone the repository

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

2. Virtual environment

• Create a virtual environment

conda create --name creatorbox python=3.11.11

• Activate the virtual environment

conda activate creatorbox

3. Install dependencies

Optional

# 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

Required

python cli.py install -f requirements.txt

4. Start and Run

python cli.py start

Note

• When installing dependencies, execute in order: first the optional items, then the required items.

• If downloads are slow, modify the mirror source:

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 --show channels

Note

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

python cli.py update --force

• If you see RuntimeError: [WinError 10060]...(1:11076), Please try restarting:

python cli.py start

• On Windows systems, simply double-click start.bat to run.

Terminal Commands

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

Access the Interface

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

🚀 Starting service... http://0.0.0.0:8000
   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.21.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

Preferences

Access the settings page at http://127.0.0.1:8000/settings.

Basic Settings	Capcut Settings	Other Settings