ComfyGit CLI

The comfygit package provides the cg and comfygit commands for managing ComfyUI environments. Version 0.7.0 depends on matched Core and Studio runtime releases and includes the packaged Studio frontend.

Install

uv tool install comfygit --upgrade
cg --version

For a source checkout, follow the root installation guide so all workspace packages come from the same checkout.

First environment

cg init --models-dir ~/ComfyUI/models --yes
cg create demo --use
cg run

Use an existing model directory to reuse model bytes across environments. Each environment retains isolated mutable ComfyUI/node checkouts and a virtualenv; uv caches can reuse package artifacts.

Workflow automation

Save the workflow in ComfyUI, then resolve dependencies explicitly:

cg -e demo workflow resolve my-workflow --auto --no-install --json --strict

Use --install to install missing resolved packages. JSON mode requires --auto and an explicit install choice. Strict mode fails if dependencies remain unresolved or uninstalled. Run the actual workflow afterward to validate runtime behavior and outputs.

Unregistered class ownership can be recorded against an already tracked package:

cg -e demo workflow node map my-workflow MyCustomNode my-package --json
cg -e demo workflow node list my-workflow --json

Inspect and control

cg -e demo status --verbose
cg -e demo orch status --json
cg -e demo orch restart --wait --timeout 180 --json
cg inventory --json --storage

Named restart requires a current cg run supervisor, matching Manager ownership and a verified idle queue. Processes started before the CLI upgrade need a relaunch. The CLI never adopts arbitrary processes by guessing their PIDs.

Authentication

cg auth status
cg auth set civitai
cg auth login huggingface

auth set uses a hidden prompt and needs working OS secure storage. The CLI ships the optional keyring adapter; headless downloads can instead use environment or provider-native credentials. Core itself has no hard keyring dependency.

Supported environment overrides include CIVITAI_API_TOKEN / CIVITAI_API_KEY, HF_TOKEN / HUGGING_FACE_HUB_TOKEN, and GITHUB_TOKEN / GH_TOKEN. Credentials are never portable manifest fields. Set COMFYGIT_HOME to select a different workspace.

Documentation and development

Use cg -h and cg COMMAND -h for the exact installed command options.

The parser and router live in comfygit_cli/cli.py, handlers in global_commands.py and env_commands.py, with strategies and formatting in separate modules. Update the curated public docs when commands change. Generate a parser-help snapshot with make -C docs/comfygit-docs generate-cli from the monorepo root; it never overwrites those docs.

uv run pytest packages/cli/tests -q
make lint

Metadata

Release files for comfygit 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for comfygit 0.7.1
File	Size	Uploaded
comfygit-0.7.1.tar.gz	108.9 kB	Sep 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for comfygit 0.7.1
File	Interpreter	ABI	Platform	Reset
comfygit-0.7.1-py3-none-any.whl 122.5 kB Sep 20, 2026	Python 3	none	any	Details

Total release size: 231.4 kB

Release files / comfygit-0.7.1.tar.gz

Download URL	comfygit-0.7.1.tar.gz
Size	108.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`4316dec4f71a5d9b827a23852d3d3e23ed4548636c1b125e82e34b9c46cfa286`
BLAKE2b-256 checksum How to use checksums	`69f9ef4f38af11fa40582fc08ad7cee33ca41cac795f055f8315d311c58c52e7`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / comfygit-0.7.1-py3-none-any.whl

Download URL	comfygit-0.7.1-py3-none-any.whl
Size	122.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c304a8a04129c0b949c8b43a95a832228ea41990ae2942a79886104724cf0c0f`
BLAKE2b-256 checksum How to use checksums	`0a83ef0451aa35e2765baf0d73ccfcda4f25faaf4eade1c842054202c0a29694`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`