Skip to content

Installation

Get ComfyGit installed and ready to use in just a few minutes.

Prerequisites

Before installing ComfyGit, make sure you have:

  • Python 3.10 or newer — Check with python --version or python3 --version
  • Operating system — Windows 10/11, macOS 10.15+, or Linux (any modern distribution)
  • Internet connection — For downloading dependencies and models

GPU Support

ComfyGit automatically detects your GPU (NVIDIA CUDA, AMD ROCm, Intel XPU) and installs the appropriate PyTorch backend. You can also specify backends manually with the --torch-backend flag.

Step 1: Install UV

UV is a fast Python package manager that ComfyGit uses to manage environments and dependencies.

curl -LsSf https://astral.sh/uv/install.sh | sh

After installation, restart your terminal or run: 

source $HOME/.cargo/env


powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation, restart PowerShell.

curl -LsSf https://astral.sh/uv/install.cmd -o install.cmd && install.cmd && del install.cmd

After installation, restart CMD.

Verify UV installation:

uv --version

You should see output like uv 0.4.x or newer.

Alternative: Install via pip

If you prefer pip: 

pip install uv

Step 2: Install ComfyGit CLI

With UV installed, install the ComfyGit CLI tool:

uv tool install comfygit

This installs the cg command globally, making it available from anywhere in your terminal.

Verify ComfyGit installation:

cg --version

You should see the ComfyGit version number.

Shell Completion

Install tab completion for your shell: 

cg completion install

Supports bash, zsh, and fish. Restart your shell after installing.

Step 3: Initialize your workspace

Create a ComfyGit workspace directory:

# Initialize in default location (~/comfygit)
cg init

# Or specify a custom path
cg init /path/to/my/workspace

The workspace is where ComfyGit stores:

  • Environments (isolated ComfyUI installations)
  • Global model index
  • Cache and logs

Workspace Structure

~/comfygit/
├── environments/          # Your ComfyUI environments
├── models/                # Shared models directory
├── comfygit_cache/       # Registry cache
├── logs/                  # Application logs
└── .metadata/             # Workspace configuration

Alternative installation methods

Install from pip

If you don't want to use UV tool isolation:

pip install comfygit

This makes cg available in your current Python environment.

Install from source

For development or testing:

# Clone the repository
git clone https://github.com/comfyhub-org/comfygit.git
cd comfygit

# Install in development mode
uv pip install -e packages/cli/

Verifying your installation

Check that everything is working:

# Check versions
cg --version
uv --version

# Initialize workspace (if not done)
cg init

# List environments (should be empty)
cg list

You should see:

No environments found. Create one with: cg create <name>

Platform-specific notes

Windows

  • WSL2 recommended — For best performance, use ComfyGit in WSL2 (Windows Subsystem for Linux)
  • Long path support — Enable long paths in Windows if you encounter path length errors: 
    New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

macOS

  • Xcode Command Line Tools — May be required for some dependencies: 
    xcode-select --install

Linux

  • System dependencies — Most distributions work out of the box. If you encounter build errors, install development tools:

    sudo apt-get update
sudo apt-get install build-essential python3-dev

    sudo dnf install gcc gcc-c++ python3-devel

    sudo pacman -S base-devel python

Updating ComfyGit

To update to the latest version:

uv tool upgrade comfygit

Or with pip:

pip install --upgrade comfygit

Uninstalling

To remove ComfyGit:

# Remove the CLI tool
uv tool uninstall comfygit

# Optionally remove your workspace
rm -rf ~/comfygit

Warning

Removing the workspace deletes all your environments and configuration. Export any important environments first with cg export.

Troubleshooting installation

UV not found after installation

Problem: Running uv shows "command not found"

Solution: Restart your terminal or manually source the environment:

source $HOME/.cargo/env

Restart PowerShell or add to PATH manually via System Properties → Environment Variables

Permission errors on Linux/macOS

Problem: Permission denied when installing

Solution: Don't use sudo with UV or pip. If needed, fix permissions:

# Fix UV permissions
chown -R $USER:$USER ~/.cargo

# For pip (if using system Python)
pip install --user comfygit

Python version too old

Problem: ComfyGit requires Python 3.10+

Solution: Install a newer Python version:

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update
sudo apt-get install python3.11

brew install python@3.11

Download from python.org

Windows installation fails

Problem: PowerShell execution policy blocks the install script

Solution: Run PowerShell as Administrator:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Then try the installation again.

Next steps

Now that ComfyGit is installed:

Getting help

If you encounter issues during installation: