Missing Models¶

Solutions for workflow model errors, index issues, and download failures.

Common scenarios¶

This guide covers troubleshooting for:

Workflow shows "missing model" or "unresolved model" errors
Model not found when searching the index
CivitAI authentication failures (401 errors)
Download failures (timeouts, 404s, network errors)
Models downloaded but not appearing in index
Workflow resolution can't find models

Workflow shows missing models¶

Problem: Running cg workflow resolve or cg status shows unresolved models.

Example error:

⚠️  Partial resolution - issues remain:
  ✗ 3 models not found

Model issues:
  • realistic_vision_v5.safetensors - not in index
  • anime_lora.safetensors - not in index
  • detail_enhancer.safetensors - not in index

Solutions:

1. Check if models directory is configured¶

cg model index status

If you see "No models directory configured":

# Set your models directory
cg model index dir ~/ComfyUI/models

# Or if starting fresh
cg model index dir ~/comfygit/workspace/models

See Setting your models directory for details.

2. Sync the index¶

If you've added models manually (browser downloads, copying files), the index may be out of date:

cg model index sync

This scans your models directory and updates the index with new files.

3. Search for the model¶

Verify if the model exists with a different filename:

# Search by partial filename
cg model index find realistic

# Search by category
cg model index list | grep checkpoints

If found but with different name, the workflow references an outdated filename.

4. Download missing models¶

If models truly don't exist, download them:

# From CivitAI
cg model download https://civitai.com/api/download/models/128078

# From HuggingFace
cg model download https://huggingface.co/stabilityai/sdxl/resolve/main/sd_xl_base_1.0.safetensors

# From direct URL
cg model download https://example.com/models/model.safetensors

See Downloading Models for details.

5. Use interactive resolution¶

Run workflow resolution with interactive prompts:

cg workflow resolve my_workflow

ComfyGit will guide you through finding or downloading missing models.

Model not found in index¶

Problem: cg model index find or cg model index show returns no results.

Example:

$ cg model index find sd_xl_base_1.0.safetensors
No models found matching: sd_xl_base_1.0.safetensors

Solutions:

1. Verify models directory is set¶

cg model index status

Expected output:

📊 Model Index Status:

   Models Directory: ✓ /home/user/ComfyUI/models
   Total Models: 148 unique models
   Total Files: 152 files indexed

If "No models directory configured", set it:

cg model index dir ~/ComfyUI/models

2. Check file actually exists¶

# List files in models directory
ls ~/ComfyUI/models/checkpoints/

# Or search filesystem
find ~/ComfyUI/models -name "*sd_xl*"

If file exists but not in index, run sync:

cg model index sync

3. Search with partial matches¶

Try broader search terms:

# Too specific - may miss variations
cg model index find sd_xl_base_1.0.safetensors

# Broader search
cg model index find sd_xl

# Even broader
cg model index find xl

4. List all models to verify¶

cg model index list

Page through results to see what's actually indexed.

CivitAI authentication failures¶

Problem: Downloads from CivitAI fail with 401 or "unauthorized" errors.

Example error:

✗ Download failed: HTTP 401 Unauthorized

Some CivitAI models require authentication.
Get your API token: https://civitai.com/user/account

Set it with:
  export CIVITAI_API_TOKEN='your-token-here'

Or add to your shell config (~/.bashrc or ~/.zshrc):
  export CIVITAI_API_TOKEN='your-token-here'

Solutions:

1. Get CivitAI API token¶

Visit civitai.com/user/account
Scroll to "API Keys"
Click "Add API Key"
Copy the generated token

2. Set the token temporarily¶

For current session only:

export CIVITAI_API_TOKEN='your-token-here'

3. Set the token permanently¶

Add to your shell config:

# For bash
echo 'export CIVITAI_API_TOKEN="your-token-here"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export CIVITAI_API_TOKEN="your-token-here"' >> ~/.zshrc
source ~/.zshrc

4. Verify token is set¶

echo $CIVITAI_API_TOKEN

Should print your token (not empty).

5. Retry download¶

cg model download https://civitai.com/api/download/models/128078

Should now work without 401 error.

Download failures (timeouts, 404s)¶

Problem: Model downloads fail with network errors, timeouts, or 404 not found.

Example errors:

✗ Download failed: HTTP 404 Not Found
✗ Download failed: Connection timeout
✗ Download failed: Network unreachable

Solutions:

1. For 404 errors - verify URL¶

# Wrong - model page, not download URL
https://civitai.com/models/4201/realistic-vision

# Right - API download endpoint
https://civitai.com/api/download/models/128078

Get correct URLs:

CivitAI: Right-click "Download" button → Copy link address
HuggingFace: Right-click file download link → Copy link address
Direct: Ensure URL is direct file download, not HTML page

2. For timeout errors - retry¶

Network timeouts are often temporary:

# Retry the download
cg model download <url>

3. For large files - check disk space¶

# Check available disk space
df -h ~/ComfyUI/models

Ensure sufficient space for model file (checkpoints: 2-7GB, loras: 50-200MB).

4. Try alternative source¶

If one source fails, try another:

# HuggingFace mirror
cg model download https://huggingface.co/user/repo/resolve/main/model.safetensors

# CivitAI mirror
cg model download https://civitai.com/api/download/models/XXXXX

# Direct from creator's hosting
cg model download https://creator-site.com/models/model.safetensors

5. Manual download workaround¶

If CLI download fails, download manually:

Download model in browser

Move to models directory:

mv ~/Downloads/model.safetensors ~/ComfyUI/models/checkpoints/

Sync index:
```
cg model index sync
```

Add source manually (optional):

cg model add-source model.safetensors <url>

Models downloaded but not appearing¶

Problem: Downloaded a model but it doesn't show in cg model index list.

Solutions:

1. Sync the index¶

ComfyGit only auto-indexes models downloaded via cg model download. For manual downloads:

cg model index sync

2. Verify file is in models directory¶

# Check if file is in the right place
ls ~/ComfyUI/models/checkpoints/

# Or find it
find ~/ComfyUI/models -name "model_name.safetensors"

If file is outside models directory, move it:

mv /path/to/file.safetensors ~/ComfyUI/models/checkpoints/
cg model index sync

3. Check models directory matches config¶

cg model index status

Verify "Models Directory" points to where you downloaded the file.

If mismatch:

# Set correct directory
cg model index dir /actual/path/to/models

4. Check file permissions¶

Ensure ComfyGit can read the file:

ls -l ~/ComfyUI/models/checkpoints/model.safetensors

If no read permission:

chmod 644 ~/ComfyUI/models/checkpoints/model.safetensors

Workflow resolution issues¶

Problem: cg workflow resolve can't find models even though they exist.

Solutions:

1. Check workflow references correct filenames¶

Workflows reference models by filename. If you have realistic_vision_v5.safetensors but workflow references realistic_vision.safetensors, resolution fails.

Fix: Rename model to match workflow expectation:

cd ~/ComfyUI/models/checkpoints
mv realistic_vision_v5.safetensors realistic_vision.safetensors
cg model index sync

2. Use interactive resolution¶

Let ComfyGit help you map models:

cg workflow resolve my_workflow

When prompted for ambiguous models, select from available options or provide download URLs.

3. Check category mismatches¶

Models must be in the correct category directory:

✗ 1 model in wrong directory

  • sd_xl_base_1.0.safetensors
    Expected: checkpoints/
    Found: loras/sd_xl_base_1.0.safetensors

Fix: Move to correct directory:

mv ~/ComfyUI/models/loras/sd_xl_base_1.0.safetensors ~/ComfyUI/models/checkpoints/
cg model index sync

4. Add model sources for auto-download¶

If model doesn't exist and you want resolution to download it:

# Add source to model metadata
cg model add-source model.safetensors https://civitai.com/api/download/models/128078

# Or run interactive add-source
cg model add-source

Then resolve will offer to download from registered sources.

Advanced troubleshooting¶

Verify model hash integrity¶

Check if model file is corrupted:

# Show model details including hash
cg model index show model.safetensors

If hash seems wrong, re-download the model.

Check workflow requirements¶

See exactly what models a workflow needs:

cg workflow show my_workflow

Look for "Models used" section to see referenced filenames.

Debug resolution process¶

Run resolution with verbose workflow details:

cg workflow resolve my_workflow

Pay attention to specific error messages for each unresolved model.

Inspect database directly¶

For advanced users, check the SQLite database:

# Show database location
cg model index status

# Query database (requires sqlite3)
sqlite3 ~/comfygit/workspace/.metadata/models.db "SELECT filename, hash, relative_path FROM models LIMIT 10;"

Prevention tips¶

Keep index synced¶

After manual downloads or file operations:

cg model index sync

Use `cg model download`¶

Prefer CLI downloads over browser downloads - automatic indexing and source registration:

cg model download <url>

If you plan to export/share environments:

# Add sources to all models
cg model add-source

# Verify before export
cg export  # Will warn if models lack sources

Standardize filenames¶

Use consistent, descriptive filenames matching common conventions:

# Good
sd_xl_base_1.0.safetensors
realistic_vision_v5.safetensors

# Avoid
model_final_2.safetensors
untitled.safetensors

Organize by category¶

Keep models in correct category directories:

models/
├── checkpoints/       # Base models
├── loras/             # LoRA adapters
├── vae/               # VAE encoders
├── controlnet/        # ControlNet models
└── upscale_models/    # Upscalers

Model Index

How the model index works and basic operations
Downloading Models

Download models from CivitAI, HuggingFace, and URLs
Adding Sources

Register download URLs for re-downloads
Managing Models

Search, organize, and maintain model collection
:material-workflow: Workflow Resolution

Resolve workflow dependencies automatically

Missing Models¶

Common scenarios¶

Workflow shows missing models¶

1. Check if models directory is configured¶

2. Sync the index¶

3. Search for the model¶

4. Download missing models¶

5. Use interactive resolution¶

Model not found in index¶

1. Verify models directory is set¶

2. Check file actually exists¶

3. Search with partial matches¶

4. List all models to verify¶

CivitAI authentication failures¶

1. Get CivitAI API token¶

2. Set the token temporarily¶

3. Set the token permanently¶

4. Verify token is set¶

5. Retry download¶

Download failures (timeouts, 404s)¶

1. For 404 errors - verify URL¶

2. For timeout errors - retry¶

3. For large files - check disk space¶

4. Try alternative source¶

5. Manual download workaround¶

Models downloaded but not appearing¶

1. Sync the index¶

2. Verify file is in models directory¶

3. Check models directory matches config¶

4. Check file permissions¶

Workflow resolution issues¶

1. Check workflow references correct filenames¶

2. Use interactive resolution¶

3. Check category mismatches¶

4. Add model sources for auto-download¶

Advanced troubleshooting¶

Verify model hash integrity¶

Check workflow requirements¶

Debug resolution process¶

Inspect database directly¶

Prevention tips¶

Keep index synced¶

Use cg model download¶

Add sources before sharing¶

Standardize filenames¶

Organize by category¶

Related documentation¶

Use `cg model download`¶