Terminal Commands 🖥️

Word count

441 words

Reading time

3 minutes

Command-line tools

Usage Help

uv run cli.py --help

Usage: cli.py [OPTIONS] COMMAND [ARGS]...

  CreatorBox CLI

Options:
  --help  Show this message and exit.

Commands:
  install  扩展安装 Extension Installation
  start    启动服务 Start service

Note

• Please activate the environment first. See the 《Startup Venv》 section.

Terminal Commands

1. Extension Installation

# iopaint
uv run cli.py install -n iopaint -p 8001 --start
# stable_diffusion_webui
uv run cli.py install -n stable_diffusion_webui -p 8002 --start
# voxcpm
uv run cli.py install -n voxcpm -p 8016 --start
# index_tts
uv run cli.py install -n index_tts -p 8014 --start
# cosyvoice
uv run cli.py install -n cosyvoice -p 8013 --start
# gpt_sovits
uv run cli.py install -n gpt_sovits -p 8015 --start

Expected output:

Python 3.10.19
Using extensions/iopaint/.venv/scripts/python.exe
📦 Installing extension 'iopaint'...
Checked 106 packages in 2ms
All installed packages are compatible
Audited 24 packages in 7ms
✅ Installation complete.
🚀 Starting extension 'iopaint'...
extensions/iopaint/.venv/scripts/python.exe main.py start --config D:\Program Files\CreatorBox\creatorbox\webapp\extensions\iopaint\data\iopaint.json
2025-11-02 18:35:13.875 | INFO     | src.utils.cbinstaller:start:206 - ✅ iopaint 已启动（PID: 1904）
2025-11-02 18:35:14.182 | INFO     | iopaint.runtime:setup_model_dir:81 - Model directory: D:\Program Files\CreatorBox\creatorbox\models
...
2025-11-02 18:35:14.225 | INFO     | iopaint.cli:start:166 - Image will be saved to D:\Program Files\CreatorBox\creatorbox\webapp\extensions\iopaint\result
...
2025-11-02 18:35:17.419 | INFO     | iopaint.api:_build_file_manager:369 - Input is directory, initialize file manager D:\Program Files\CreatorBox\creatorbox\webapp\extensions\iopaint\picture
2025-11-02 18:35:17.428 | INFO     | iopaint.model_manager:init_model:47 - Loading model: lama
2025-11-02 18:35:17.430 | INFO     | iopaint.helper:load_jit_model:107 - Loading model from: D:\Program Files\CreatorBox\creatorbox\models\torch\hub\checkpoints\big-lama.pt
INFO:     Started server process [2588]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8001 (Press CTRL+C to quit)

2. Start Service

• Default

uv run cli.py start

• Specify host and port

uv run cli.py start -h 0.0.0.0 -p 8000

• Enable intranet tunneling

uv run cli.py start -h 0.0.0.0 -p 8000 -nh toucan-real-informally.ngrok-free.app -np 8000 --ngrok

Expected output:

✅ Ngrok tunnel started: NgrokTunnel: "https://toucan-real-informally.ngrok-free.app" -> "http://localhost:8000"
🚀 Starting service... http://0.0.0.0:8000
   _____                _            ______
  /  __ \              | |           | ___ \
  | /  \/_ __ ___  __ _| |_ ___  _ __| |_/ / _____  __
  | |   | '__/ _ \/ _` | __/ _ \| '__| ___ \/ _ \ \/ /
  | \__/\ | |  __/ (_| | || (_) | |  | |_/ / (_) >  <
   \____/_|  \___|\__,_|\__\___/|_|  \____/ \___/_/\_\   v1.0.30.7d765e86

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 you see RuntimeError: this license key is expired, try forcing an update:

git pull

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

uv run --extra {gpu|cpu} cli.py start

• 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

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.