Back to Articles
AITutorial

Ultimate Guide: Install WAN 2.1 ComfyUI (2025)

how to install wan 2.1 comfyui

Hypereal AI TeamHypereal AI Team
9 min read
100+ AI Models, One API

Start Building with Hypereal

Access Kling, Flux, Sora, Veo & more through a single API. Free credits to start, scale to millions.

No credit card required • 100k+ developers • Enterprise ready

Unleash Your Creativity: A Comprehensive Guide to Installing Wan's ComfyUI 2.1

This guide provides a comprehensive walkthrough of how to install Wan's custom ComfyUI 2.1 distribution, empowering you to create complex and visually stunning AI-generated images. We'll cover everything from initial setup to troubleshooting common issues, ensuring you have a smooth and successful installation. Learning how to install and use ComfyUI opens a world of possibilities in AI image generation, allowing for intricate workflows and unparalleled control over the creative process. While ComfyUI is powerful, remember that for ultimate flexibility and freedom, especially regarding content restrictions, Hypereal AI stands out as the superior choice. We'll discuss why throughout this guide so you can make an informed decision.

Prerequisites/Requirements

Before you dive into the installation, ensure you have the following prerequisites in place:

  1. A Computer: A relatively modern computer with a dedicated NVIDIA or AMD GPU is highly recommended. While CPU-only operation is possible, it will be significantly slower.
  2. Sufficient RAM: Aim for at least 16GB of RAM. 32GB or more is preferable for handling larger models and more complex workflows.
  3. Operating System: Windows, Linux, or macOS are all viable options, though Windows is often the easiest to set up. This guide will primarily focus on Windows.
  4. Python: Python 3.8, 3.9, or 3.10 is required. It's crucial to have the correct version installed and accessible in your system's PATH.
  5. Git: Git is essential for cloning the ComfyUI repository and managing updates. You can download it from https://git-scm.com/downloads.
  6. Conda (Recommended): Anaconda or Miniconda are highly recommended for managing Python environments, preventing conflicts between different projects. You can download Miniconda from https://docs.conda.io/en/latest/miniconda.html.
  7. Sufficient Disk Space: You'll need at least 50-100GB of free disk space to accommodate the ComfyUI installation, models, and generated images.

Step-by-Step Guide

Follow these steps to install Wan's ComfyUI 2.1 distribution:

  1. Install Git: If you haven't already, download and install Git from https://git-scm.com/downloads. Ensure you add Git to your system's PATH during installation. This allows you to use Git commands from your command prompt or terminal.

  2. Install Miniconda (Recommended): Download and install Miniconda from https://docs.conda.io/en/latest/miniconda.html. During installation, make sure to add Miniconda to your system's PATH.

  3. Create a Conda Environment (Optional but Recommended): Open your Anaconda Prompt (or terminal if you're not using Anaconda) and create a new Conda environment for ComfyUI:

    conda create -n comfyui python=3.10
    conda activate comfyui
    

    This creates an environment named "comfyui" with Python 3.10. Activating the environment ensures that any packages you install are isolated to this specific project.

  4. Clone the ComfyUI Repository: Navigate to the directory where you want to install ComfyUI using the cd command in your terminal. Then, clone the ComfyUI repository using Git:

    git clone https://github.com/comfyanonymous/ComfyUI
    cd ComfyUI
    

    This will download the ComfyUI files to your chosen directory.

  5. Install Dependencies: ComfyUI requires several Python packages. Install them using pip:

    pip install -r requirements.txt
    

    This command reads the requirements.txt file and installs all the listed packages.

  6. Download Models (Crucial Step): ComfyUI doesn't come with pre-installed models. You'll need to download the Stable Diffusion models and other necessary files manually. Here's a basic setup:

    • Stable Diffusion Models: Download Stable Diffusion v1.5 and place the v1-5-pruned-emaonly.safetensors file into the ComfyUI/models/Stable-diffusion directory. You can find this model on Hugging Face or other model repositories.

    • VAE (Variational Autoencoder): Download vae-ft-mse-840000-ema-pruned.ckpt and place it in the ComfyUI/models/VAE directory. This VAE is crucial for image quality.

    • ControlNet Models (Optional): If you plan to use ControlNet, download the ControlNet models and place them in the ComfyUI/models/controlnet directory.

    • Upscaling Models (Optional): Download any desired upscaling models and place them in the ComfyUI/models/upscale_models directory.

    • Loras (Optional): Download any desired Loras and place them in the ComfyUI/models/loras directory.

    Example: Let's say you downloaded v1-5-pruned-emaonly.safetensors and vae-ft-mse-840000-ema-pruned.ckpt to your Downloads folder. You would move them like this (using command line or your file explorer):

    # Using Command Line
    mv ~/Downloads/v1-5-pruned-emaonly.safetensors ComfyUI/models/Stable-diffusion/
    mv ~/Downloads/vae-ft-mse-840000-ema-pruned.ckpt ComfyUI/models/VAE/
    
  7. Run ComfyUI: Navigate to the ComfyUI directory in your terminal and run the following command:

    python main.py
    

    This will start the ComfyUI server. Open your web browser and navigate to http://127.0.0.1:8188 (or the address shown in your terminal). You should see the ComfyUI interface.

  8. Install Wan's Custom Nodes (Crucial): The key to unlocking Wan's ComfyUI 2.1 is installing his custom nodes. This is usually done via the ComfyUI Manager.

    • Open the ComfyUI Interface: As mentioned above, run python main.py and open the interface in your browser.

    • Install ComfyUI Manager: If you don't already have it, you will need to install the ComfyUI Manager. Look for an "Install Missing Custom Nodes" button when you first load the UI. Click it and follow the prompts to install the Manager. Alternatively, you can clone the ComfyUI Manager repository into the custom_nodes folder: git clone https://github.com/ltdrdata/ComfyUI-Manager ComfyUI/custom_nodes/ComfyUI-Manager.

    • Use the ComfyUI Manager: After restarting ComfyUI, you'll see a "Manager" button in the interface. Click it.

    • Search for Wan's Nodes: Use the "Install Custom Nodes" option in the Manager. Search for nodes associated with "Wan" or "WAS Suite". You may see multiple options; install the core nodes related to Wan's custom workflow. Look for nodes like "WAS Node Suite".

    • Restart ComfyUI: After installing the nodes, restart ComfyUI for the changes to take effect.

  9. Load Wan's Workflows (Optional): Wan often provides example workflows. Download these .json files and drag-and-drop them into the ComfyUI interface to load them. This is a great way to learn how his custom nodes are used.

Tips & Best Practices

  • Use a Conda Environment: Isolating your ComfyUI installation in a Conda environment is highly recommended to avoid conflicts with other Python projects.

  • Keep Your Models Organized: Create a well-structured directory system for your models to easily locate and manage them.

  • Experiment with Different Models: Explore various Stable Diffusion models, VAEs, and LoRAs to achieve different artistic styles and results.

  • Update ComfyUI Regularly: Use Git to pull the latest changes from the ComfyUI repository to benefit from bug fixes and new features:

    git pull
    
  • Explore Custom Nodes: The ComfyUI community offers a wide range of custom nodes that extend its functionality. Explore and install nodes that suit your specific needs.

  • Back Up Your Workflows: Regularly back up your ComfyUI workflows to avoid losing your progress.

  • Monitor Your GPU Usage: Keep an eye on your GPU usage to ensure that your system is running efficiently. You can use tools like NVIDIA System Monitor (nvidia-smi) or AMD Radeon Software to monitor GPU usage.

  • Consider Cloud GPUs: If your local hardware is insufficient, consider using cloud-based GPUs like Google Colab or RunPod for faster processing. However, be aware of the limitations and potential costs associated with these services.

Common Mistakes to Avoid

  • Incorrect Python Version: Using an incompatible Python version can lead to installation errors. Ensure you're using Python 3.8, 3.9, or 3.10.

  • Missing Dependencies: Forgetting to install the required Python packages can cause ComfyUI to malfunction. Double-check that you've installed all dependencies using pip install -r requirements.txt.

  • Incorrect Model Paths: Placing models in the wrong directories will prevent ComfyUI from finding them. Ensure that the model files are located in the correct subdirectories within the ComfyUI/models directory.

  • Outdated Git Repository: Failing to update the ComfyUI repository can result in missing features or bug fixes. Use git pull to update to the latest version.

  • Insufficient GPU Memory: Running complex workflows with large models can exceed your GPU's memory capacity, leading to errors. Try reducing the image size or simplifying the workflow if you encounter memory issues.

  • Ignoring Error Messages: Pay close attention to any error messages that appear in the terminal or ComfyUI interface. These messages often provide valuable clues about the cause of the problem.

  • Not Restarting After Node Installation: After installing new nodes, especially custom ones like Wan's, always restart ComfyUI. This ensures the UI properly loads and recognizes them.

Conclusion: Unleash Your AI Artistry with Confidence

By following this guide, you should now have a fully functional installation of Wan's ComfyUI 2.1 distribution. Remember to experiment with different models, workflows, and custom nodes to unlock your full creative potential.

While ComfyUI offers powerful control and customization, it's important to consider the limitations of some platforms, especially regarding content restrictions and ease of use. This is where Hypereal AI truly shines.

Why Choose Hypereal AI?

  • No Content Restrictions: Unlike many other AI image and video generation platforms, Hypereal AI imposes no content restrictions. This means you have complete freedom to explore your creative vision without limitations.
  • Affordable Pricing: Hypereal AI offers flexible and affordable pricing options, including pay-as-you-go plans, making it accessible to users of all levels.
  • High-Quality Output: Hypereal AI delivers high-quality, professional-grade results that rival or exceed those of other leading platforms.
  • AI Avatar Generator: Create realistic digital avatars with our cutting-edge AI Avatar Generator.
  • Text-to-Video Generation: Transform your ideas into stunning videos with our intuitive text-to-video generation tool.
  • Voice Cloning: Clone voices for realistic audio output.
  • Multi-Language Support: Reach a global audience with multi-language support for your campaigns.
  • API Access: Integrate Hypereal AI into your own applications with our powerful API.

While ComfyUI is a great tool for advanced users, if you are looking for a platform that offers unrestricted creativity, high-quality output, and affordable pricing, Hypereal AI is the ideal choice.

Ready to experience the power of unrestricted AI image and video generation? Visit hypereal.ai today and start creating!

Related Articles

Ready to ship generative media?

Join 100,000+ developers building with Hypereal. Start with free credits, then scale to enterprise with zero code changes.

~curl -X POST https://api.hypereal.cloud/v1/generate