---
name: ComfyUI启动必须用venv的python
description: 重启/启动 ComfyUI 必须用 /home/ls/comfy/ComfyUI/venv/bin/python，系统 python3 缺 sqlalchemy 会启动失败
type: reference
---

启动或重启 ComfyUI 时，**必须用 venv 的 python**：`/home/ls/comfy/ComfyUI/venv/bin/python`

完整启动命令：
`cd /home/ls/comfy/ComfyUI && nohup /home/ls/comfy/ComfyUI/venv/bin/python main.py --disable-pinned-memory --enable-dynamic-vram --fast-disk --vram-headroom 3 --async-offload > /tmp/comfyui_xxx.log 2>&1 &`

**Why:** 直接用系统 `python3`（`/usr/bin/python3`）启动会报 `ModuleNotFoundError: No module named 'sqlalchemy'`，ComfyUI 在加载 app.assets 时崩溃（HTTP 502）。venv 里装了 sqlalchemy 2.0.51（python 3.12.3）。之前正常起来的 ComfyUI（PID 337677）就是用 venv python 起的。

**How to apply:** 任何启动/重启 ComfyUI（含服务卡死恢复）都用 venv 绝对路径 python，别用 `python3`。kill 卡死 ComfyUI 用 `ss -ltnp | grep 8188` 拿 PID 再 `kill -9`；注意 `pkill -f` 会误杀当前 shell，别用。
