huchukato dd961386c7 Fix placeholder paths and model name parsing
1. Changed placeholder paths to relative './' instead of absolute
2. Enhanced model name parsing to use model_info['name'] when available
3. Fallback to model_id parsing for better display names
4. Should show 'wan2.2-Remix' instead of 'Unknown Model' when possible
2026-02-21 03:07:14 +01:00
2026-02-21 03:02:15 +01:00
2026-02-21 03:05:02 +01:00
2025-04-01 15:01:19 +07:00
2025-08-09 17:28:50 +08:00
2025-04-01 15:01:19 +07:00

ComfyUI-HuggingFace - HuggingFace Model Downloader for ComfyUI

ComfyUI-HuggingFace seamlessly integrates HuggingFace's vast model repository directly into ComfyUI, allowing you to search, download, and organize AI models without leaving your workflow.

Features

  • Integrated Model Search: Search HuggingFace's extensive library directly from ComfyUI
  • One-Click Downloads: Download models with associated metadata and files
  • Automatic Organization: Models are automatically saved to their appropriate directories
  • Clean UI: Clean, intuitive interface that complements ComfyUI's aesthetic
  • HF API Integration: Full support for HuggingFace API endpoints
  • Model Type Detection: Automatically categorizes models (checkpoints, loras, etc.)

Installation

Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/huchukato/ComfyUI-HuggingFace.git

ComfyUI Manager

  1. Open ComfyUI Manager
  2. Search for "ComfyUI-HuggingFace"
  3. Click Install

Usage

  1. Start ComfyUI with ComfyUI-HuggingFace installed
  2. Access the HuggingFace panel from the HuggingFace menu button at the right top area
  3. Search for models using HuggingFace's powerful search
  4. Click the download button on any model to save it to your local installation
  5. Models become immediately available in ComfyUI nodes

Configuration

  • HuggingFace API Token: Optional but recommended for higher rate limits
    • Set HUGGINGFACE_API_KEY environment variable
    • Or enter token in ComfyUI-HuggingFace settings
  • Global Download Root: Optional custom download directory
    • When set, saves to <global_root>/<model_type>
    • Example: /runpod-volume/ComfyUI/checkpoints
    • When empty, uses default ComfyUI paths

Supported Model Types

  • Checkpoints: Main model files (.safetensors, .bin)
  • LoRAs: Low-Rank Adaptation models
  • Text Encoders: CLIP and other encoder models
  • VAEs: Variational Autoencoders
  • Embeddings: Text embedding models
  • Custom: Any model type from HuggingFace

API Endpoints Used

  • /api/models - Model search
  • /api/models/{id} - Model information
  • /api/models/{id}/tree - File listing
  • /api/models/{id}/resolve/main/{filename} - File downloads

Development

This is a fork of Civicomfy, adapted for HuggingFace integration:

  • Replaced Civitai API with HuggingFace API
  • Updated URL parsing for HF model structure
  • Maintained the same clean UI/UX
  • Added HF-specific features

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Areas for Contribution

  • Additional model type support
  • UI/UX improvements
  • Performance optimizations
  • Bug fixes and testing

Requirements

  • ComfyUI
  • Python 3.8+
  • requests library
  • Valid HuggingFace account (optional)

License

This project follows the same license as the original Civicomfy project.

Acknowledgments

  • Based on Civicomfy by MoonGoblinDev
  • HuggingFace for the amazing model repository
  • ComfyUI community for feedback and support
S
Description
No description provided
Readme MIT
3.2 MiB
Languages
Python 60.1%
JavaScript 32.6%
CSS 7.3%