CreatorBox

简体中文

English

简体中文

English

切换主题

/CreatorBox/static/jms_logo.CZ_EMIVr.png

终端命令 🖥️ ​

终端命令行工具

使用帮助 ​

bash
python cli.py --help
bash
Usage: cli.py [OPTIONS] COMMAND [ARGS]...

  CreatorBox CLI

Options:
  --help  Show this message and exit.

Commands:
  install  依赖安装 Dependency Installation
  proxy    网络代理 Proxy settings
  auth     认证鉴权 Authentication
  start    启动服务 Start service
  update   检查更新 Check for updates

终端命令 ​

1. 依赖安装 ​

  • 可选
bash
# 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
  • 必须
bash
python cli.py install -f requirements.txt

正常返回结果

log
Installing from requirements.txt...
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple/
Requirement already satisfied: torch==2.6.0 in d:\projects\miniconda\envs\creatorbox\lib\site-packages (from -r requirements.txt (line 2)) (2.6.0)
Requirement already satisfied: torchaudio==2.6.0 in d:\projects\miniconda\envs\creatorbox\lib\site-packages (from -r requirements.txt (line 3)) (2.6.0)
Requirement already satisfied: torchvision==0.21.0 in d:\projects\miniconda\envs\creatorbox\lib\site-packages (from -r requirements.txt (line 4)) (0.21.0)
Requirement already satisfied: numpy==1.26.4 in d:\projects\miniconda\envs\creatorbox\lib\site-packages (from -r requirements.txt (line 5)) (1.26.4)
...
✅ Installation complete.
Environment Info:
-  Platform                 : Windows
-  Python version           : 3.11.11
-  ==============           :
-  torch                    : 2.6.0
-  torchaudio               : 2.6.0
-  torchvision              : 0.21.0
-  numpy                    : 1.26.4
-  ...

注意

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

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

pip

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

conda

bash
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

2. 网络代理 ​

  • 默认
bash
python cli.py proxy -h 127.0.0.1 -p 10808
  • 用户认证
bash
python cli.py proxy -h 127.0.0.1 -p 10810 -u admin -pwd 123456
  • 指定站点
bash
python cli.py proxy -h 127.0.0.1 -p 10810 -u admin -pwd 123456 -s https://www.youtube.com -t 5

正常返回结果

log
🌐 Starting proxy verify. -> https://www.youtube.com
✅ Proxy verified successfully.

提示

  • 代理配置，验证成功后无需开启 v2rayN 全局模式
  • 支持参数 --proxy 命令行工具，均可使用此配置

3. 启动服务 ​

  • 默认
bash
python cli.py start
  • 指定host + 端口
bash
python cli.py start -h 0.0.0.0 -p 80
  • 开启内网透传
bash
python cli.py start -h 0.0.0.0 -p 80 -nh toucan-real-informally.ngrok-free.app -np 80 --ngrok

正常返回结果

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

2025-08-14 22:35:18.134 | INFO  3144  main.py:122 - Build on master at 2025-08-12 15:11:54 started run successfully (14.42 seconds)
2025-08-14 22:35:19.216 | INFO  3144  main.py:166 - Proxy enabled and verified successfully.
2025-08-14 22:35:19.223 | INFO  3144  main.py:134 - Startup scheduler 2 job completed.
2025-08-14 22:35:19.223 | INFO  3144  main.py:135 - Startup gradio 0 app completed.
2025-08-14 22:35:19.226 | INFO  3144  main.py:136 - http://192.168.0.100:80

注意

  • Windows 直接双击 start.bat 运行
  • 启动报错 RuntimeError: this license key is expired，请尝试强制更新
bash
python cli.py update --force

4. 检查更新 ​

  • 默认最新
bash
python cli.py update
  • 版本回退
bash
python cli.py update -t 1.0.16
bash
python cli.py update -c 788a0a42
  • 强制更新
bash
python cli.py update --force

正常返回结果

log
📦 Force resetting to origin/master...
HEAD is now at 788a0a42 命令行支持网络代理、授权认证

认证鉴权 ​

1. 邮箱注册 ​

  • 随机密码
bash
python cli.py auth -a register -e xiesx123@gmail.com
  • 指定密码
bash
python cli.py auth -a register -e xiesx123@gmail.com -p 123456
  • 指定密码 + 使用代理
bash
python cli.py auth -a register -e xiesx123@gmail.com -p 123456 --proxy

正常返回结果

log
😊 Starting register -> xiesx123@gmail.com
✅ register successfully. please check your email to verify.

2. 账号登录 ​

  • 默认
bash
python cli.py auth -a login -e xiesx123@gmail.com -p 123456
  • 使用代理
bash
python cli.py auth -a login -e xiesx123@gmail.com -p 123456 --proxy

正常返回结果

log
😊 Starting login -> xiesx123@gmail.com
✅ Login successfully. token -> eyJhbGciOiJSUzI1NiIsImtpZCI6IjJiN2JhZ
hZmIyZjEwY2FlMmIxZjA3ZjM4MTZjNTQyMmJlY2NhNWMyMjMiLCJ0eXAiOiJKV1QifQXX
eyJpc3MiOiJodHRwczovL3NlY3VyZXRva2VuLmdvb2dsZS5jb20vdGVzdC1mOWQxMSIsI
CI6InRlc3QtZjlkMTEiLCJhdXRoX3RpbWUiOjE3NTUxNjE4NzEsInVzZXJfaWQiOiJYdj
dROUFpZnNUVUhuTXo2WmRIZWhvYndUb0czIiwic3ViIjoiWHY3UTlBaWZzVFVIbk16Nlp
....
kSGVob2J3VG9HMyIsImlhdCI6MTc1NTE2MTg3MSwiZXhwIjoxNzU1MTY1NDcxLCJlbWFp

3. 账号信息 ​

  • 默认
bash
python cli.py auth -a user -e xiesx123@gmail.com -p 123456
  • 使用代理
bash
python cli.py auth -a user -e xiesx123@gmail.com -p 123456 --proxy

正常返回结果

log
😊 Starting user -> xiesx123@gmail.com
✅ User successfully. uuid -> Q5tsyLZQtPMjOnSoK7chAdQVcdi2 (free)

4.修改密码 ​

  • 默认
bash
python cli.py auth -a resetpwd -e xiesx123@gmail.com
  • 使用代理
bash
python cli.py auth -a resetpwd -e xiesx123@gmail.com --proxy

正常返回结果

log
😊 Starting resetpwd -> xiesx123@gmail.com
✅ Resetpwd successfully. please check your email to reset your password.

注意

  • 程序不会记录保存密码信息
  • 授权认证过程中，邮箱注册、密码重置 时会通过 Google Firebase 发出邮件进行认证
邮箱验证密码重置
auth_user_verify_mailauth_user_rest_password_mail