ComfyUI User Guide

A practical guide to generating images with ComfyUI on the Haiven server.

Getting Started

Access the UI

Open https://comfyui.haiven.site in your browser.

Default Workflow

ComfyUI loads with a basic text-to-image workflow. The default nodes are:

1. Load Checkpoint - Select your model
2. CLIP Text Encode (Prompt) - Positive prompt (what you want)
3. CLIP Text Encode (Prompt) - Negative prompt (what to avoid)
4. KSampler - Generation settings (steps, CFG, sampler)
5. VAE Decode - Convert latent to image
6. Save Image - Output to disk

Quick Start: Generate Your First Image

1. In Load Checkpoint, select a model (e.g., sd_xl_base_1.0.safetensors)
2. Enter your prompt in the positive CLIP Text Encode node
3. Enter negatives like blurry, low quality, watermark in the negative node
4. Click Queue Prompt (or press Ctrl+Enter)
5. Watch progress in the UI - image appears when done

Installing Models

Method 1: ComfyUI Manager (Recommended)

1. Click Manager button in the sidebar
2. Go to Install Models
3. Search for model name
4. Click Install → downloads directly to server

Method 2: CivitAI Download Script (Recommended for CivitAI)

Download any CivitAI model directly to the correct folder using the download-civitai.sh script. It auto-detects the model type (checkpoint, LoRA, embedding, etc.) and places the file in the right directory.

cd /mnt/apps/docker/ai/comfyui-api

# From a CivitAI model page URL (downloads latest version)
./download-civitai.sh https://civitai.com/models/133005/juggernaut-xl

# From a URL with a specific version
./download-civitai.sh https://civitai.com/models/133005?modelVersionId=357609

# From a raw version ID
./download-civitai.sh 357609

# With API token (for restricted models)
./download-civitai.sh https://civitai.com/models/12345 --token YOUR_API_KEY

# Or set the token as an environment variable
export CIVITAI_API_TOKEN="your-key-here"
./download-civitai.sh https://civitai.com/models/12345

How it works:
1. Fetches model metadata from CivitAI API
2. Reads the model type and maps it to the correct local directory
3. Shows a summary (name, type, size, destination) before downloading
4. Downloads with a progress bar
5. Warns if the file already exists

Type-to-directory mapping:

Getting a CivitAI API token (needed for some models):
1. Go to https://civitai.com/user/account
2. Scroll to "API Keys"
3. Create a new key
4. Use with --token flag or CIVITAI_API_TOKEN env var

Method 3: Manual Upload (SCP)

From your local machine:

# Checkpoints
scp -P 25636 ~/Downloads/model.safetensors \
    elijahryoung@10.0.0.42:/mnt/models/image/checkpoints/

# LoRAs
scp -P 25636 ~/Downloads/lora.safetensors \
    elijahryoung@10.0.0.42:/mnt/models/image/loras/

After uploading (any method), click the refresh button (🔄) next to model dropdowns in ComfyUI.

Model Directories

ComfyUI uses symlinks to access models stored in /mnt/models/image/. The following model directories are available:

Adding New Model Symlinks

If a new model type folder is needed (e.g., clip_vision):

# Create symlink as the comfyui user
sudo ln -sfn /mnt/models/image/<folder_name> /opt/comfyui/ComfyUI/models/<folder_name>

# Verify the symlink
ls -la /opt/comfyui/ComfyUI/models/<folder_name>

Available Models

Checkpoints

Embeddings (Textual Inversions)

Embeddings go in /mnt/models/image/embeddings/. Use them in your negative prompt by typing the filename (without extension).

Note: SDXL and FLUX models generally don't need embeddings — their negative prompts work well with plain text. Embeddings are most useful with SD 1.5 models.

Recommended Settings by Model

SDXL Models

• Resolution: 1024x1024 (or 896x1152, 1152x896)
• Steps: 20-30
• CFG Scale: 7-8
• Sampler: euler_ancestral or dpmpp_2m
• Scheduler: karras

SDXL Turbo

• Resolution: 512x512 or 1024x1024
• Steps: 4-8
• CFG Scale: 1-2 (very low!)
• Sampler: euler_ancestral

SD 1.5 Models

• Resolution: 512x512 (or 768x512)
• Steps: 20-30
• CFG Scale: 7-8
• Sampler: euler_ancestral or dpmpp_2m

Using LoRAs

1. Add a Load LoRA node (right-click → Add Node → loaders)
2. Connect it between Load Checkpoint and CLIP Text Encode
3. Select your LoRA file
4. Set strength_model and strength_clip (start with 0.7-1.0)
5. Include trigger words in your prompt if the LoRA requires them

Keyboard Shortcuts

Saving & Loading Workflows

Save Workflow

• Ctrl+S → saves to browser's downloads as .json
• Or: Menu → Save

Load Workflow

• Ctrl+O → select .json file
• Or: Drag .json file onto canvas
• Or: Drag image with embedded workflow onto canvas

Share Workflows

Workflow data is embedded in generated PNG images. Share the image, and others can drag it into ComfyUI to get your exact setup.

Output Images

Generated images are saved to:
- Server path: /mnt/storage/generated-images/
- Organized by date: 2025-11-29/ComfyUI_00001_.png

To download images:
1. Right-click image in UI → Save Image
2. Or browse via SCP/SFTP to /mnt/storage/generated-images/

Installing Custom Nodes

Via ComfyUI Manager

1. Click Manager → Install Custom Nodes
2. Search for the node pack
3. Click Install
4. Restart ComfyUI: sudo systemctl restart comfyui

Manual Installation

cd /opt/comfyui/ComfyUI/custom_nodes
sudo -u comfyui git clone https://github.com/user/custom-node-repo.git
sudo systemctl restart comfyui

Troubleshooting

Model not appearing

1. Verify file location: ls /mnt/models/image/checkpoints/
2. Click refresh (🔄) in the model dropdown
3. Restart: sudo systemctl restart comfyui

Generation stuck / no output

1. Check logs: journalctl -u comfyui -f
2. Look for CUDA errors or OOM (out of memory)
3. Try a smaller resolution or fewer steps

WebSocket disconnected

1. Refresh the browser page
2. If persistent, check: systemctl status comfyui

Out of VRAM

The RTX PRO 6000 Blackwell pro6000-charlie has 96GB VRAM. If you hit limits:
- Reduce resolution
- Use fewer steps
- Disable preview (saves ~1GB)
- Close other GPU applications

Check GPU usage

watch -n 1 nvidia-smi

Tips & Best Practices

1. Start simple - Get a basic workflow working before adding complexity
2. Save frequently - Use Ctrl+S to save workflow iterations
3. Use seed - Set a specific seed to reproduce results
4. Batch size 1 - Start with batch size 1, increase for variations
5. Preview method - "auto" is set; disable for faster processing
6. Negative prompts matter - Always include quality negatives

Effective Negative Prompts

blurry, low quality, watermark, signature, text, logo,
bad anatomy, bad hands, missing fingers, extra fingers,
cropped, worst quality, jpeg artifacts

Getting Help

• ComfyUI Docs: https://docs.comfy.org
• ComfyUI GitHub: https://github.com/comfyanonymous/ComfyUI
• r/comfyui: https://reddit.com/r/comfyui
• Server Logs: journalctl -u comfyui -f

Example Workflows

Basic Text-to-Image (SDXL)

Load Checkpoint (sd_xl_base_1.0)
    ↓
CLIP Text Encode (positive) → "a serene mountain lake at sunset, photorealistic"
CLIP Text Encode (negative) → "blurry, low quality, watermark"
    ↓
KSampler (steps=25, cfg=7, sampler=euler_ancestral, scheduler=karras)
    ↓
VAE Decode
    ↓
Save Image

SDXL Turbo (Fast)

Load Checkpoint (sd_xl_turbo_1.0_fp16)
    ↓
CLIP Text Encode (positive) → "your prompt"
CLIP Text Encode (negative) → ""  # can be empty for turbo
    ↓
KSampler (steps=4, cfg=1, sampler=euler_ancestral)
    ↓
VAE Decode
    ↓
Preview Image

Last updated: 2026-02-19