准备本地 Runtime

在仓库根目录执行。准备完成后，你会得到 Runtime READY，再进入启动与转谱。

开始前

• Windows x64，RTX 3070 Ti Laptop，标称 8 GiB VRAM。
• 已安装 Git、uv 与可用的 NVIDIA 驱动。
• 模型下载约 9.19 GB；Doctor 另要求 10 GiB 工作余量。
• 使用独立的 Python 3.12.13 Runtime 环境。

只在自己的就绪环境执行

这些命令会准备代码、下载依赖与模型。真实 GPU 请求须由当前 resource owner 串行运行。

1. 准备锁定环境

命令克隆锁定的 Runtime 与自定义节点，并安装锁文件中的依赖。已有 checkout 必须匹配锁定提交，且没有 tracked 修改。

# Run from the repository root. Downloads pinned source and dependencies.
uv run --no-project --python 3.12.13 python runtime/comfyui/manage.py prepare
if ($LASTEXITCODE -ne 0) { throw "Runtime preparation failed. Preserve local edits and inspect the command output." }

完整示例: runtime/comfyui/examples/prepare.ps1 ↗

2. 准备模型

权重保存到 data/models/。YuE2 与 SheetSage2 权重采用 CC-BY-NC-4.0；代码许可独立记录。

# Run from the repository root. Writes model weights and resumable downloads.
uv run --project runtime/comfyui --no-sync python runtime/comfyui/manage.py download-models
if ($LASTEXITCODE -ne 0) { throw "Model preparation failed. Inspect the output before resuming downloads." }

完整示例: runtime/comfyui/examples/download-models.ps1 ↗

3. 得到就绪结果

param([ValidateRange(1, 65535)][int]$Port = 8188)

# Run from the repository root. A real CUDA check requires the GPU resource owner.
uv run --project runtime/comfyui --no-sync python runtime/comfyui/manage.py doctor --port $Port
if ($LASTEXITCODE -ne 0) { throw "Runtime is not ready. Follow the reported recovery actions before starting." }

完整示例: runtime/comfyui/examples/doctor.ps1 ↗

成功输出 Runtime READY，退出码为 0。失败输出 Runtime NOT READY，退出码为 1，并给出逐项恢复动作。

如果模型下载中断，重新执行 download-models 续传。.part 文件不算就绪。

下一步

阅读 Doctor 的检查边界，再保存启动前 receipt、启动本地服务并执行转谱。

检查并启动 Runtime →

源码版本: 1ce3268正文来源: docs/learn/quickstart.md