ComfyUI MiniMax-Remover

A ComfyUI custom node for fast and effective video/image object removal using MiniMax optimization. Remove objects from videos and images with high quality results using only 6-12 inference steps.

✨ Features

• 🚀 Fast: Only 6-12 inference steps required, no CFG needed
• 🎯 Effective: Seamlessly removes objects from videos and images
• 💪 Robust: Prevents regeneration of unwanted objects or artifacts
• 🔧 Easy to Use: Simple ComfyUI nodes with intuitive workflows
• 📱 Flexible: Supports both single images and video processing
• ⚡ Optimized: Automatic model downloading and caching
• 💡 Smart Hints: Automatic backend suggestions for optimal settings

🛠️ Installation

Method 1: ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "MiniMax-Remover"
3. Click Install
4. Restart ComfyUI

Method 2: Manual Installation

1. Navigate to your ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes

2. Clone this repository:

git clone https://github.com/1038lab/ComfyUI-MiniMax-Remover.git

3. Install dependencies:

cd ComfyUI-MiniMax-Remover

For Portable ComfyUI (Windows):

..\..\..\python_embeded\python.exe -m pip install -r requirements.txt

For Standard Python Installation:

pip install -r requirements.txt

4. Restart ComfyUI

📥 Model Download

Models will be automatically downloaded from HuggingFace when first used.

Manual Model Download (Optional)

If automatic download fails or you prefer manual installation:

1. Download using HuggingFace CLI:

huggingface-cli download zibojia/minimax-remover --include vae transformer scheduler --local-dir ./models/MiniMax-Remover

2. Or download manually from HuggingFace:

   • Visit: https://huggingface.co/zibojia/minimax-remover
   • Download the vae, transformer, and scheduler folders
   • Place them in: ComfyUI/models/MiniMax-Remover/

3. Verify installation:

   • Check that ComfyUI/models/MiniMax-Remover/ contains:
     • vae/ folder
     • transformer/ folder
     • scheduler/ folder

📦 Available Nodes

Node Name	Display Name	Purpose
MinimaxImageRemover	MiniMax Image Object Remover	Remove objects from single images (requires external model loader)
MinimaxVideoRemover	MiniMax Video Object Remover	Remove objects from videos (requires external model loader)
MinimaxModelLoader	MiniMax Model Loader	Load VAE, Transformer, and Scheduler for separate nodes
MinimaxVideoLoader	MiniMax Video Loader	Load video files for processing
ImageSizeAdjuster	MiniMax Image Size Adjuster	Adjust image dimensions for compatibility

⚙️ Recommended Settings

MiniMax Model Loader (Advanced)

• scheduler_type: FlowMatchEulerDiscreteScheduler (recommended) or UniPCMultistepScheduler
• torch_dtype: float16 (GPU recommended) or float32 (CPU/compatibility)
• device: auto (automatic detection)

🎨 Mask Requirements

Supported Formats

• ✅ Grayscale images (recommended)
• ✅ RGB images (automatically converted)
• ✅ PNG, JPG, TIFF and other common formats

Mask Guidelines

• Black background, white foreground (standard mask format)
• High contrast for better edge detection
• Complete coverage of objects to remove
• Clean edges without excessive noise
• Avoid overly complex details in small areas

🚀 Performance Tips

GPU Memory Optimization

1. Use float16 precision (reduces memory by ~50%)
2. Keep image resolution reasonable (≤1024x1024 recommended)
3. Use fewer inference steps (6-12 usually sufficient)
4. Close other GPU applications to free VRAM

Processing Speed

1. FlowMatchEulerDiscreteScheduler is typically faster than UniPCMultistepScheduler
2. temporal_frames=3 provides best speed/quality balance
3. Use ImageSizeAdjuster node to optimize image dimensions for better performance

🔧 Requirements

System Requirements

• Python: 3.8 or higher
• GPU: NVIDIA GPU with CUDA support (recommended)
• RAM: 8GB+ system RAM
• VRAM: 6GB+ GPU memory for optimal performance

Dependencies

All dependencies are automatically installed via requirements.txt:

torch>=1.13.0
diffusers>=0.21.0
decord>=0.6.0
einops>=0.6.0
scipy>=1.9.0
opencv-python>=4.5.0
huggingface_hub>=0.16.0
accelerate>=0.20.0

❓ Troubleshooting

Common Issues

Model Download Fails

• Try manual download from HuggingFace website
• Check internet connection and HuggingFace access
• Ensure sufficient disk space in ComfyUI/models/MiniMax-Remover/

CUDA Out of Memory

• Reduce image resolution
• Use float16 instead of float32
• Reduce num_inference_steps
• Close other applications using GPU

Tensor Dimension Errors

• Ensure mask and image have compatible dimensions
• Enable fix_dimensions in the All-in-One node for automatic adjustment
• Use ImageSizeAdjuster node for manual dimension control
• Check that images are RGB (not RGBA)

Dimension Warning Messages

• If you see "Image dimensions not divisible by 16" warning, enable fix_dimensions=True
• The All-in-One node will automatically suggest this when needed

Poor Removal Quality

• Increase num_inference_steps (try 16-20)
• Improve mask quality (higher contrast, cleaner edges)
• Adjust mask_dilation_iterations based on mask precision
• Try different scheduler types

📚 Additional Resources

• Original MiniMax-Remover Paper
• HuggingFace Model Repository
• ComfyUI Documentation

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

🙏 Acknowledgments

• MiniMax-Remover Team for the original research and implementation
• ComfyUI Community for the excellent framework and ecosystem
• HuggingFace for model hosting and distribution
• Contributors who helped improve this custom node

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

⭐ Support

If you find this project helpful, please consider giving it a star on GitHub! It helps others discover the project and motivates continued development.

---

Made with ❤️ for the ComfyUI community