Ultimate Guide: Install WAN 2.1 ComfyUI (2025)
how to install wan 2.1 comfyui
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:
- 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.
- Sufficient RAM: Aim for at least 16GB of RAM. 32GB or more is preferable for handling larger models and more complex workflows.
- 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.
- 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.
- Git: Git is essential for cloning the ComfyUI repository and managing updates. You can download it from https://git-scm.com/downloads.
- 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.
- 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:
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.
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.
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 comfyuiThis creates an environment named "comfyui" with Python 3.10. Activating the environment ensures that any packages you install are isolated to this specific project.
Clone the ComfyUI Repository: Navigate to the directory where you want to install ComfyUI using the
cdcommand in your terminal. Then, clone the ComfyUI repository using Git:git clone https://github.com/comfyanonymous/ComfyUI cd ComfyUIThis will download the ComfyUI files to your chosen directory.
Install Dependencies: ComfyUI requires several Python packages. Install them using pip:
pip install -r requirements.txtThis command reads the
requirements.txtfile and installs all the listed packages.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.safetensorsfile into theComfyUI/models/Stable-diffusiondirectory. You can find this model on Hugging Face or other model repositories.VAE (Variational Autoencoder): Download
vae-ft-mse-840000-ema-pruned.ckptand place it in theComfyUI/models/VAEdirectory. 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/controlnetdirectory.Upscaling Models (Optional): Download any desired upscaling models and place them in the
ComfyUI/models/upscale_modelsdirectory.Loras (Optional): Download any desired Loras and place them in the
ComfyUI/models/lorasdirectory.
Example: Let's say you downloaded
v1-5-pruned-emaonly.safetensorsandvae-ft-mse-840000-ema-pruned.ckptto 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/Run ComfyUI: Navigate to the ComfyUI directory in your terminal and run the following command:
python main.pyThis 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.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.pyand 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_nodesfolder: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.
Load Wan's Workflows (Optional): Wan often provides example workflows. Download these
.jsonfiles 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 pullExplore 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/modelsdirectory.Outdated Git Repository: Failing to update the ComfyUI repository can result in missing features or bug fixes. Use
git pullto 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.
