ComfyGit
Git for your ComfyUI environments — version control, package management, and reproducible sharing.
Status: Early release, actively developed. Feedback welcome via GitHub Issues or Discord.
Highlights
- 🔄 Isolated environments — test new nodes without breaking production
- 📦 Git-based versioning — commit changes, rollback when things break
- 🚀 One-command sharing — export/import complete working environments
- 💾 Smart model management — content-addressable index, no duplicate storage
- 🔧 Standard tooling — built on UV and pyproject.toml, works with Python ecosystem
- 🖥️ Cross-platform — Windows, Linux, macOS
[!NOTE]
For a visual UI inside ComfyUI, check out ComfyGit Manager
How Is This Different From ComfyUI Manager?
ComfyUI Manager helps you browse, install, and update custom nodes in a single shared ComfyUI setup. ComfyGit focuses on isolated, version-controlled environments you can reproduce and share anywhere.
- ComfyUI Manager: manage nodes in-place (one environment)
- ComfyGit: create per-project environments with commits, branches, rollback, export/import
- Together: install ComfyUI Manager inside a ComfyGit environment and use both
Installation
# With UV (recommended)
uv tool install comfygit
# Or with pip
pip install comfygit
Need UV? See UV installation.
Quick Start
$ cg init
Initialized ComfyGit workspace at ~/comfygit
$ cg create my-project --use
Created environment 'my-project'
Active environment: my-project
$ cg node add comfyui-impact-pack
Resolving comfyui-impact-pack...
Installing ComfyUI-Impact-Pack from registry
+ comfyui-impact-pack@1.2.3
$ cg commit -m "Initial setup with Impact Pack"
[main a28f333] Initial setup with Impact Pack
1 file changed, 15 insertions(+)
$ cg -e my-project run
Starting ComfyUI at http://localhost:8188
What About My Existing Setup?
ComfyGit creates new, isolated ComfyUI environments inside your ComfyGit workspace. Your existing ComfyUI install (and anything in it) is untouched.
Models are stored once and symlinked into environments, so you can share the same model library across projects without duplicating storage.
For your first environment, expect roughly ~2GB of downloads for ComfyUI and base dependencies.
See the documentation for more examples including version control workflows, sharing environments, and team collaboration.
Documentation
Full documentation at docs.comfygit.org including:
Features
Environments
cg create <name> # Create new environment
cg list # List all environments
cg use <name> # Set active environment
cg status # Show environment state
cg run # Run ComfyUI
Nodes
cg node add <id> # Add from registry
cg node add <github-url> # Add from GitHub
cg node remove <id> # Remove node
cg node list # List installed nodes
Version Control
cg commit -m "message" # Save snapshot
cg log # View history
cg revert <commit> # Undo a commit
cg checkout <commit> # Explore old state
Sharing
cg export <file.tar.gz> # Export environment
cg import <file.tar.gz> # Import environment
cg push / cg pull # Sync with git remote
Contributing
Contributions welcome! See CONTRIBUTING.md for details.
License