Git for your ComfyUI environments — version control, package management, and reproducible sharing.

Status: Early release, actively developed. Feedback welcome via GitHub Issues or Discord.

• 🔄 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

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

# With UV (recommended)
uv tool install comfygit

# Or with pip
pip install comfygit

Need UV? See UV installation.

$ 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

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.

Full documentation at docs.comfygit.org including:

• How It Works — architecture and design
• Model Management — content-addressable indexing
• Sharing Environments — export/import and git remotes

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

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

cg commit -m "message"        # Save snapshot
cg log                        # View history
cg revert <commit>            # Undo a commit
cg checkout <commit>          # Explore old state

cg export <file.tar.gz>       # Export environment
cg import <file.tar.gz>       # Import environment
cg push / cg pull             # Sync with git remote

Contributions welcome! See CONTRIBUTING.md for details.

• GitHub Issues — bugs and features
• GitHub Discussions — questions and ideas
• Discord — community chat

ComfyGit is dual-licensed under GPL-3.0 for open-source use and proprietary licenses for commercial use. See the LICENSE.txt for more information.