comfy cli

Comfy-Cli: Alat Baris Perintah untuk ComfyUI

nyaman-cli adalah alat baris perintah yang membantu pengguna menginstal dan mengelola ComfyUI dengan mudah, kerangka pembelajaran mesin sumber terbuka yang kuat. Dengan nyaman-cli, Anda dapat dengan cepat mengatur ComfyUI, menginstal paket, dan mengelola node khusus, semuanya dari kenyamanan terminal Anda.

Demo

Fitur

• Instalasi ComfyUI yang mudah dengan satu perintah
• ? Manajemen paket yang mulus untuk ekstensi dan dependensi ComfyUI
• ? Manajemen node khusus untuk memperluas fungsionalitas ComfyUI
• ?️ Unduh pos pemeriksaan dan simpan hash model
• Kompatibilitas lintas platform (Windows, macOS, Linux)
• Dokumentasi dan contoh yang komprehensif

Instalasi

1. (Disarankan, tetapi tidak perlu) Aktifkan lingkungan virtual (venv/conda)

2. Untuk menginstal nyaman-cli, pastikan Anda telah menginstal Python 3.9 atau lebih tinggi di sistem Anda. Kemudian, jalankan perintah berikut:

   pip install comfy-cli

Pelengkapan Otomatis Shell

Untuk menginstal petunjuk pelengkapan otomatis di shell Anda, jalankan:

comfy --install-completion

Hal ini memungkinkan Anda mengetik comfy [TAP] untuk melengkapi perintah dan opsi secara otomatis

Penggunaan

Menginstal ComfyUI

Untuk menginstal ComfyUI menggunakan nyaman, jalankan saja:

comfy install

Perintah ini akan mengunduh dan mengatur versi terbaru ComfyUI dan ComfyUI-Manager di sistem Anda. Jika Anda menjalankan repo ComfyUI yang sudah dikonfigurasi. Perintah ini hanya akan memperbarui file comfort.yaml untuk mencerminkan pengaturan lokal

• comfy install --skip-manager : Instal ComfyUI tanpa ComfyUI-Manager.
• comfy --workspace=<path> install : Instal ComfyUI ke <path>/ComfyUI .
• Untuk comfy install , jika tidak ada spesifikasi jalur seperti --workspace, --recent, or --here yang disediakan, maka secara implisit akan dipasang di <HOME>/comfy .

Menentukan jalur eksekusi

• Anda dapat menentukan jalur ComfyUI di mana perintah akan diterapkan melalui indikator jalur sebagai berikut:

  • comfy --workspace=<path> : Jalankan dari ComfyUI yang diinstal di ruang kerja yang ditentukan.
  • comfy --recent : Jalankan dari ComfyUI yang baru saja dijalankan atau diinstal.
  • comfy --here : Jalankan dari ComfyUI yang terletak di direktori saat ini.

• Opsi --workspace, --recent, dan --here tidak dapat digunakan secara bersamaan.

• Jika tidak ada indikator jalur, prioritas berikut ini berlaku:

  • Jalankan dari ComfyUI default di jalur yang ditentukan oleh comfy set-default <path> .
  • Jalankan dari ComfyUI yang baru saja dijalankan atau diinstal.
  • Jalankan dari ComfyUI yang terletak di direktori saat ini.

• Contoh 1: Untuk menjalankan ComfyUI yang baru saja dijalankan:

  • comfy --recent launch

• Contoh 2: Untuk menginstal paket di ComfyUI di direktori saat ini:

  • comfy --here node install ComfyUI-Impact-Pack

• Contoh 3: Untuk memperbarui jalur ComfyUI dan node kustom yang dipilih secara otomatis berdasarkan prioritas:

  • comfy node update all

• Anda dapat menggunakan perintah comfy which untuk memeriksa jalur ruang kerja target.

  • misalnya comfy --recent which , comfy --here which , comfy which , ...

Pengaturan Bawaan

Defaultnya menetapkan opsi yang akan dieksekusi secara default ketika tidak ada ComfyUI ruang kerja tertentu yang ditetapkan untuk perintah tersebut.

comfy set-default <workspace path> ?[--launch-extras="<extra args>"]

• Opsi --launch-extras menentukan argumen tambahan yang diterapkan hanya selama peluncuran secara default. Namun, jika tambahan ditentukan pada saat peluncuran, pengaturan ini diabaikan.

Luncurkan ComfyUI

Comfy menyediakan perintah yang memungkinkan Anda menjalankan ComfyUI yang diinstal dengan mudah.

comfy launch

• Untuk dijalankan dengan opsi ComfyUI default:

  comfy launch -- <extra args...>

  comfy launch -- --cpu --listen 0.0.0.0

  • Saat Anda mengonfigurasi opsi tambahan secara manual, tambahan yang ditetapkan berdasarkan set-default akan ditimpa.

• Untuk menjalankan latar belakang

  comfy launch --background

  comfy --workspace=~/comfy launch --background -- --listen 10.0.0.10 --port 8000

  • Instance yang diluncurkan dengan --background ditampilkan di bagian "Background ComfyUI" dari comfy env , menyediakan fungsi manajemen untuk satu instance latar belakang saja.
  • Karena "Server Nyaman Berjalan" di comfy env hanya menampilkan port default 8188, itu tidak menampilkan ComfyUI yang berjalan pada port berbeda.
  • ComfyUI yang berjalan di latar belakang dapat dihentikan dengan comfy stop .

Mengelola Node Kustom

nyaman menyediakan cara mudah untuk mengelola node khusus untuk memperluas fungsionalitas ComfyUI. Berikut beberapa contohnya:

• Tampilkan informasi node khusus:

 comfy node [show|simple-show] [installed|enabled|not-installed|disabled|all|snapshot|snapshot-list]
                             ?[--channel <channel name>]
                             ?[--mode [remote|local|cache]]

• comfy node show all --channel recent

  comfy node simple-show installed

  comfy node update all

  comfy node install ComfyUI-Impact-Pack

• Mengelola cuplikan:

  comfy node save-snapshot

  comfy node restore-snapshot <snapshot name>

• Instal dependensi:

  comfy node install-deps --deps=<deps .json file>

  comfy node install-deps --workflow=<workflow .json/.png file>

• Hasilkan deps:

  comfy node deps-in-workflow --workflow=<workflow .json/.png file> --output=<output deps .json file>

Membagi dua node khusus

Jika Anda menemukan bug hanya ketika node kustom diaktifkan, dan ingin mengetahui node kustom mana yang menyebabkan bug, alat membagi dua dapat membantu Anda menentukan node kustom yang menyebabkan masalah.

• comfy node bisect start : Mulai sesi bisect baru dengan argumen peluncuran ComfyUI opsional. Secara otomatis menandai keadaan awal sebagai buruk, dan mengambil semua node yang diaktifkan ketika perintah dijalankan sebagai set pengujian.
• comfy node bisect good : Tandai set aktif saat ini sebagai baik, yang menunjukkan bahwa masalahnya tidak ada dalam set pengujian.
• comfy node bisect bad : Menandai set aktif saat ini sebagai buruk, yang menunjukkan bahwa masalahnya ada dalam set pengujian.
• comfy node bisect reset : Mengatur ulang sesi membagi dua saat ini.

Mengelola Model

• Pengunduhan model

  comfy model download --url <URL> ?[--relative-path <PATH>] ?[--set-civitai-api-token <TOKEN>]

  • URL: CivitAI, url file pelukan, ...

• Hapus model

  comfy model remove ?[--relative-path <PATH>] --model-names <model names>

• Daftar model

  comfy model list ?[--relative-path <PATH>]

Mengelola Manajer UI yang Nyaman

• nonaktifkan GUI ComfyUI-Manager (nonaktifkan menu Manajer dan Server)

  comfy manager disable-gui

• aktifkan GUI ComfyUI-Manager

  comfy manager enable-gui

• Hapus tindakan startup yang dicadangkan:

  comfy manager clear

Fitur Beta: format comfort-lock.yaml (WIP)

 basic:

models:
  - model: [name of the model]
    url: [url of the source, e.g. https://huggingface.co/...]
    paths: [list of paths to the model]
      - path: [path to the model]
      - path: [path to the model]
    hashes: [hashes for the model]
      - hash: [hash]
        type: [AutoV1, AutoV2, SHA256, CRC32, and Blake3]
    type: [type of the model, e.g. diffuser, lora, etc.]

  - model:
  ...

# compatible with ComfyUI-Manager's .yaml snapshot
custom_nodes:
  comfyui: [commit hash]
  file_custom_nodes:
  - disabled: [bool]
    filename: [.py filename]
    ...
  git_custom_nodes:
    [git-url]:
      disabled: [bool]
      hash: [commit hash]
    ...

Analisis

Kami melacak analitik menggunakan Mixpanel untuk membantu kami memahami pola penggunaan dan mengetahui di mana harus memprioritaskan upaya kami. Saat Anda pertama kali mengunduh cli, ia akan meminta Anda untuk memberikan persetujuan. Jika suatu saat Anda ingin memilih untuk tidak ikut serta:

 comfy tracking disable

Lihat penggunaannya di sini: Mixpanel Board

Berkontribusi

Kami menyambut kontribusi untuk nyaman-cli! Jika Anda mempunyai ide, saran, atau laporan bug, silakan buka terbitan di repositori GitHub kami. Jika Anda ingin menyumbangkan kode, silakan fork repositori dan kirimkan permintaan penarikan.

Lihat Panduan Pengembang untuk lebih jelasnya.

Lisensi

nyaman dirilis di bawah GNU General Public License v3.0.

Mendukung

Jika Anda mengalami masalah atau memiliki pertanyaan tentang nyaman-cli, silakan buka masalah di repositori GitHub kami atau hubungi kami di Discord. Kami akan dengan senang hati membantu Anda!

Selamat berdifusi dengan ComfyUI dan nyaman-cli! ?