feat: recommend uv for Python setup in connection panel

Users without Python installed were getting stuck on pip install comfy-cli.
Restructure the Quick Start to install uv first (which is cross-platform,
a single-line shell install, and doesn't require Python itself to be
present). Then use uv pip install comfy-cli --system. Keep the plain
pip path in the collapsible Alternative section with a note about the
Python 3.10+ requirement.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
snomiao
2026-04-12 02:11:02 +09:00
parent 970194e2be
commit f7f80616e0
2 changed files with 58 additions and 20 deletions

View File

@@ -3766,12 +3766,16 @@
"connected": "Connected — backend is reachable.",
"connectAndGo": "Connect & Open ComfyUI",
"quickStart": "Quick Start with Comfy CLI",
"quickStartDescription": "The fastest way to get ComfyUI running locally:",
"step1Install": "1. Install comfy-cli:",
"step2Install": "2. Install ComfyUI:",
"step3Launch": "3. Launch with CORS enabled:",
"altManualSetup": "Alternative: Manual Python Setup",
"guideDescription": "If you already have ComfyUI cloned, start it with CORS enabled:",
"quickStartDescription": "The fastest way to get ComfyUI running locally. No existing Python install required — uv handles it for you.",
"step1InstallUv": "1. Install uv (macOS/Linux, then Windows):",
"uvNote": "uv is a fast Python package manager that auto-installs Python itself, so you don't need Python preinstalled. After install, restart your terminal.",
"step2InstallComfyCli": "2. Install comfy-cli:",
"step3InstallComfyui": "3. Install ComfyUI:",
"step4Launch": "4. Launch with CORS enabled:",
"altManualSetup": "Alternative: I already have Python installed",
"altPipDescription": "If you already have Python 3.10+ and pip available, you can install comfy-cli directly:",
"altPipNote": "Note: older Python versions (<3.10) may fail to install some comfy-cli dependencies.",
"guideDescription": "If you already have ComfyUI cloned, start it with CORS enabled from the repo root:",
"corsNote": "The --enable-cors-header flag allows this preview page to communicate with your local backend.",
"localAccess": "Local Network Access",
"localAccessDescription": "Your browser may prompt for permission to access local network devices. Allow it so this page can reach your local ComfyUI instance.",

View File

@@ -112,18 +112,37 @@
<div class="flex flex-col gap-2">
<div class="flex flex-col gap-1">
<span class="text-xs font-medium text-neutral-400">
{{ t('connectionPanel.step1Install') }}
{{ t('connectionPanel.step1InstallUv') }}
</span>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
pip install comfy-cli
curl -LsSf https://astral.sh/uv/install.sh | sh
</code>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
</code>
<p class="text-xs text-neutral-500">
{{ t('connectionPanel.uvNote') }}
</p>
</div>
<div class="flex flex-col gap-1">
<span class="text-xs font-medium text-neutral-400">
{{ t('connectionPanel.step2InstallComfyCli') }}
</span>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
uv pip install comfy-cli --system
</code>
</div>
<div class="flex flex-col gap-1">
<span class="text-xs font-medium text-neutral-400">
{{ t('connectionPanel.step2Install') }}
{{ t('connectionPanel.step3InstallComfyui') }}
</span>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
@@ -134,7 +153,7 @@
<div class="flex flex-col gap-1">
<span class="text-xs font-medium text-neutral-400">
{{ t('connectionPanel.step3Launch') }}
{{ t('connectionPanel.step4Launch') }}
</span>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
@@ -149,22 +168,37 @@
</p>
</section>
<!-- Alternative: manual python -->
<!-- Alternative: manual python / pip -->
<details class="group">
<summary
class="cursor-pointer text-sm font-medium text-neutral-400 hover:text-neutral-300"
>
{{ t('connectionPanel.altManualSetup') }}
</summary>
<div class="mt-2 flex flex-col gap-2">
<p class="text-xs text-neutral-400">
{{ t('connectionPanel.guideDescription') }}
</p>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
python main.py --enable-cors-header="*"
</code>
<div class="mt-2 flex flex-col gap-3">
<div class="flex flex-col gap-1">
<p class="text-xs text-neutral-400">
{{ t('connectionPanel.altPipDescription') }}
</p>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
pip install comfy-cli
</code>
<p class="text-xs text-neutral-500">
{{ t('connectionPanel.altPipNote') }}
</p>
</div>
<div class="flex flex-col gap-1">
<p class="text-xs text-neutral-400">
{{ t('connectionPanel.guideDescription') }}
</p>
<code
class="block rounded-md bg-neutral-800 p-3 text-xs text-neutral-200 select-all"
>
python main.py --enable-cors-header="*"
</code>
</div>
</div>
</details>