CreatorBox

简体中文

English

简体中文

English

切换主题

/CreatorBox/images/jms_logo.png

常见问题 ❓ ​

字数
734 字
阅读
4 分钟

安装使用过程问题汇总

网络 ​

请确保你的 网络 是正常的，VPN 需要打开全局模式或者在设置中 启用网络代理

安装 ​

使用 gpu 显卡 ​

解决方法

参考配置

bash
nvidia-smi
​
logs
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2024 NVIDIA Corporation
Built on Thu_Jun__6_02:18:23_PDT_2024
Cuda compilation tools, release 12.5, V12.5.82
Build cuda_12.5.r12.5/compiler.34385749_0
Sat Jul 12 14:42:54 2025
+---------------------------------------------------------------------------------------+
| NVIDIA-SMI 560.35.03            Driver Version: 560.35.03      CUDA Version: 12.6     |
|---------------------------------------+------------------------+----------------------+
| GPU  Name               Persistence-M | Bus-Id          Disp.A | Volatile Uncorr. ECC |
| Fan  Temp   Perf        Pwr:Usage/Cap |           Memory-Usage | GPU-Util  Compute M. |
|                                       |                        |               MIG M. |
|=======================================+========================+======================|
|   0  Tesla T4                     Off |   00000000:00:04.0 Off |                    0 |
| N/A   39C    P8            9W /   70W |       1MiB /  15360MiB |      0%      Default |
|                                       |                        |                  N/A |
+---------------------------------------+------------------------+----------------------+
|   1  Tesla T4                     Off |   00000000:00:05.0 Off |                    0 |
| N/A   41C    P8            9W /   70W |       1MiB /  15360MiB |      0%      Default |
|                                       |                        |                  N/A |
+---------------------------------------+------------------------+----------------------+

参考版本

2.6.0+cu124

bash
uv pip install torch==2.6.0+cu124 torchvision==0.21.0+cu124 torchaudio==2.6.0+cu124 --extra-index-url https://download.pytorch.org/whl/cu124

2.6.0+cu126

bash
uv pip install torch==2.6.0+cu126 torchvision==0.21.0+cu126 torchaudio==2.6.0+cu126 --extra-index-url https://download.pytorch.org/whl/cu126

...

更多

启动 ​

启动报错 ​

解决方法
  • 启动报错 RuntimeError: this license key is expired，请尝试远程更新
bash
git pull
  • 启动报错 RuntimeError: [WinError 10060]...(1:11076)，请尝试重新启动
bash
uv run cli.py start

  • Windows 直接双击 start.bat 或 桌面快捷方式图标 运行

  • 默认使用 CPU 运行，如需开启 GPU，见 《使用 GPU 显卡》 章节

启动环境 ​

解决方法

命令启动，需要提前 cmd 进行环境激活，以 D:\Program Files\CreatorBox 为例

  • 默认环境
bash
D: & cd "D:\Program Files\CreatorBox\creatorbox" & "D:\Program Files\CreatorBox\creatorbox\.venv\Scripts\activate.bat"
  • 扩展环境
bash
# index_tts
D: & cd "D:\Program Files\CreatorBox\creatorbox\extensions\index_tts" & "D:\Program Files\CreatorBox\creatorbox\extensions\index_tts\.venv\Scripts\activate.bat"
# cosyvoice
D: & cd "D:\Program Files\CreatorBox\creatorbox\extensions\cosyvoice" & "D:\Program Files\CreatorBox\creatorbox\extensions\cosyvoice\.venv\Scripts\activate.bat"
# gpt_sovits
D: & cd "D:\Program Files\CreatorBox\creatorbox\extensions\gpt_sovits" & "D:\Program Files\CreatorBox\creatorbox\extensions\gpt_sovits\.venv\Scripts\activate.bat"
...

正常结果返回

log
(creatorbox) D:\Program Files\CreatorBox\creatorbox>
(index_tts) D:\Program Files\CreatorBox\creatorbox\extensions\index_tts>
(cosyvoice) D:\Program Files\CreatorBox\creatorbox\extensions\cosyvoice>
(gpt_sovits) D:\Program Files\CreatorBox\creatorbox\extensions\gpt_sovits>
...

然后在输入命令

使用 ​

设备未就绪 ​

解决方法
log
PermissionError: [WinError 21] 设备未就绪

如果安装在系统盘，需要以管理员身份运行，不建议

配音语言配置 ​

使用方式

默认内置 10 种语言，支持自定义添加节点

webapp\data\settings.json
json
{
    "locales": [
        {
            "name": "中国",
            "locale": "zh-CN",
            "country": "China",
            "enable": true
        }
    ]
    // ...
}

使用 VPN 异常 ​

解决方法
log
Retrying 1 time(s), translation_json ->
Your location is not supported by google-generativeai at the moment.
Try to use ChatVertexAI LLM from langchain_google_vertexai., waiting 5.0 seconds before retrying.
  • 出现 Your location is not supported 等类似描述，说明 IP 被封，尝试切换代理地区
  • 推荐代理，见 《JustMySocks》 章节

使用 Ngrok 报错 ​

解决方法
log
PyngrokNgrokError:
The ngrok process errored on start: authentication failed:
Your account is limited to 1 simultaneous ngrok agent sessions.
You can run multiple simultaneous tunnels from a single agent session by defining the tunnels in your agent configuration file and starting them with the command `ngrok start --all`.
Read more about the agent configuration file: https://ngrok.com/docs/secure-tunnels/ngrok-agent/reference/config
You can view your current agent sessions in the dashboard:
https://dashboard.ngrok.com/agents ERR_NGROK_108.

启动出现上述错误，则需要 进入 Ngrok DashBoard https://dashboard.ngrok.com/agents ，关闭正在运行的代理，重新运行

模型 ​

模型下载失败 ​

解决方法
log
An error occured while synchronizing the model Systran/faster-whisper-large-v3 from the Hugging Face Hub:
An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the
specified revision on the local disk. Please check your internet connection and try again.
Trying to load the model directly from the local cache, if it exists.

通过国内镜像下载模型

说话人调用错误 ​

解决方法
log
2025-04-18 07:29:31.094 | INFO whisper_.py:102 - Loading Speaker model on device cuda
2025-04-18 07:29:31.865 | ERROR whisper_.py:106 - Error: 401 Client Error: Unauthorized for url: https://hf-mirror.com/pyannote/speaker-diarization-3.1/resolve/main/config.yaml (Request ID: Root=1-6801ff5b-0270fbd846adbc761e229ace;fddee4c5-7f49-4739-bba3-42cbc47dca6e)
  1. 前往并接受 pyannote/segmentation-3.0 的用户协议
  2. 接受 pyannote/speaker-diarization-3.1 的用户协议
  3. 前往并获取访问令牌：huggingface.co/settings/tokens