CreatorBox

English

简体中文

English

简体中文

Appearance

Local Deployment 🔧 ​

Run locally

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

Requirements ​

  • Operating System: Windows10+, MacOS 11+, 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 ​

  • Ensure your network is functioning properly, and VPN should be set to global traffic mode
  • Do not install Conda in Chinese paths or paths with spaces to avoid unexpected issues

TIP

For virtual environment setup, see 《Preparation》

Installation Steps ​

1. Clone the repository ​

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

2. Virtual environment ​

  • Create a virtual environment
bash
conda create --name creatorbox python=3.11.11
  • Activate the virtual environment
bash
conda activate creatorbox

3. Install dependencies ​

bash
python cli.py install -f src/support/third_party/cosyvoice/requirements.txt # Optional
python cli.py install -f src/support/third_party/f5_tts/requirements.txt    # Optional
python cli.py install -f requirements.txt                                   # Required

4. Start and Run ​

bash
python cli.py start

5. Check Update ​

bash
python cli.py update

Note

    1. When installing dependencies, execute in order: first the optional items, then the required items.
    1. If downloads are slow, modify the mirror source:
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
    1. On Windows systems, simply double-click start.bat to run.

Access the Interface ​

log
_____                _            ______
/  __ \              | |           | ___ \
| /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
| |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
| \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  < 
\____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.15.c393f6c

2025-06-03 19:38:19.383 | INFO 1184 main.py:99 -  Build on master at 2025-06-03 10:05:20 started run Debug success (5.64 seconds)
2025-06-03 19:38:19.385 | INFO 1184 task.py:27 -  Startup scheduler 2 job completed.
2025-06-03 19:38:19.385 | INFO 1184 main.py:109 - Startup gradio 0 app completed.
2025-06-03 19:38:19.386 | INFO 1184 main.py:110 - http://172.18.0.1:8000

Preferences ​

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