ComfyUI sur Fedora 43 : Deux environnements virtuels + Démarrage en un clic (mars 2026)

Date : Mars 2026
OS : Fedora 43
Objectif : Conserver deux venvs Python (ex. 3.12 + 3.14) pour la compatibilité, mais démarrer ComfyUI automatiquement avec une configuration propre et légère.

Enterprise Delivery Operating System

Ce guide fait partie de la série Enterprise Delivery Operating System. Utilisez ces hubs de catégories pour naviguer dans l'ensemble de la pile (infra → workflows → gouvernance).

Pourquoi conserver deux venvs ?

Les outils d'IA évoluent rapidement. Certains nœuds et wheels sont en retard sur la version la plus récente de Python, tandis que d'autres l'exigent.

• venv Python 3.12 → « ennuyeux mais compatible » (TensorRT/LW wheels/Lightning sont souvent plus stables)
• venv Python 3.14 → fonctionnalités les plus récentes, mais les wheels manquantes / problèmes d'importation sont courants

Règle : ne mélangez jamais les installations entre les venvs. Lancez toujours ComfyUI depuis le venv souhaité.

Configuration : Un script par venv

Créez un petit script de lancement qui :
1) se déplace dans le dossier ComfyUI
2) active le venv choisi
3) lance ComfyUI sur localhost

1) Créer un lanceur pour le venv Python 3.12

mkdir -p ~/.local/bin

cat > ~/.local/bin/comfyui-start-312.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

cd /home/x/ai/ComfyUI
source /home/x/ai/ComfyUI/.venv312/bin/activate
exec python main.py --listen 127.0.0.1 --port 8188
EOF

chmod +x ~/.local/bin/comfyui-start-312.sh

2) (Optionnel) Créer un lanceur pour le venv Python 3.14

cat > ~/.local/bin/comfyui-start-314.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

cd /home/x/ai/ComfyUI
source /home/x/ai/ComfyUI/.venv/bin/activate
exec python main.py --listen 127.0.0.1 --port 8189
EOF

chmod +x ~/.local/bin/comfyui-start-314.sh

Maintenant, vous pouvez exécuter l'une ou l'autre version sans réfléchir :

• ~/.local/bin/comfyui-start-312.sh
• ~/.local/bin/comfyui-start-314.sh

Démarrage automatique : service utilisateur systemd (meilleure option)

Cela lance ComfyUI à la connexion, redémarre en cas de plantage et reste minimaliste (pas de root, pas de wrappers lourds).

1) Créer le service utilisateur pour 3.12

mkdir -p ~/.config/systemd/user

cat > ~/.config/systemd/user/comfyui312.service <<'EOF'
[Unit]
Description=ComfyUI (Python 3.12 venv)
After=network.target

[Service]
Type=simple
WorkingDirectory=/home/x/ai/ComfyUI
ExecStart=/home/x/.local/bin/comfyui-start-312.sh
Restart=on-failure
RestartSec=2
Environment=PYTHONUNBUFFERED=1

[Install]
WantedBy=default.target
EOF

2) Activer + démarrer

systemctl --user daemon-reload
systemctl --user enable --now comfyui312.service
systemctl --user status comfyui312.service --no-pager

3) Journaux (débogage)

journalctl --user -u comfyui312.service -f

(Si vous voulez aussi le service 3.14, répétez l'opération avec comfyui314.service et l'autre script.)

GUI en un clic : Lanceur de bureau (ouvrir ComfyUI dans le navigateur)

Ceci crée une entrée d'application dans votre menu. En cliquant dessus :
1) lance le service
2) ouvre l'interface dans votre navigateur

mkdir -p ~/.local/share/applications

cat > ~/.local/share/applications/comfyui.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=ComfyUI (Local)
Comment=Start ComfyUI and open the UI
Exec=sh -lc 'systemctl --user start comfyui312.service; xdg-open http://127.0.0.1:8188'
Icon=utilities-terminal
Terminal=false
Categories=Graphics;AI;
EOF

Notes pour éviter les erreurs courantes

• Si vous voyez pip s'installer dans ~/.local/..., vous n'êtes pas dans le bon venv (ou vous ne l'avez pas activé).
• Si un nœud échoue avec pkg_resources manquant → installez setuptools à l'intérieur du venv choisi : source /home/x/ai/ComfyUI/.venv312/bin/activatepython -m pip install -U pip setuptools wheel
• Les échecs des nœuds TensorRT sont normaux sur les versions plus récentes de Python : si vous n'en avez pas besoin, désactivez ce dossier de nœuds personnalisés.

Lectures suivantes

Si vous souhaitez approfondir, ces guides se connectent directement à la configuration ci-dessus :

Compromis (rapide)

service utilisateur systemd

• ✅ stable, redémarrage automatique, faible surcharge, propre
• ⛔ nécessite une configuration initiale unique

lanceur de bureau

• ✅ flux de travail en un clic
• ⛔ dépend toujours de l'interface utilisateur du navigateur

deux venvs

• ✅ le meilleur des deux mondes (compatibilité + dernières versions)
• ⛔ vous devez séparer les ports/services pour éviter toute confusion