ComfyUI Blender Wrapper is a tool that enables users to execute Blender in headless mode from ComfyUI or any Python environment, facilitating the use of reusable pipeline stages stored in .blend files. It allows for the seamless exchange of configurations through JSON, specifically designed for technical art and asset pipeline tasks such as cleanup, decimation, unwrapping, baking, and rigging.
- Provides a generic
wrapper.pythat manages environment variables, imports assets into Blender, and executes scripts from.blendfiles, returning results in JSON format. - Includes an example ComfyUI node to demonstrate how to utilize the wrapper effectively, along with sample
.blendfiles for common tasks. - Features modifications to existing wrappers, improving compatibility with batch processing and addressing Windows path issues.
Context
The ComfyUI Blender Wrapper serves as a bridge between ComfyUI and Blender, allowing users to leverage Blender's extensive capabilities without the need for complex integrations. It simplifies the execution of various Blender tasks by enabling the use of pre-defined stages stored within .blend files, making it ideal for users involved in technical art and asset management.
Key Features & Benefits
The tool's primary feature is the generic wrapper.py, which automates the process of calling Blender and executing specific tasks defined in .blend files. This functionality is crucial for users who need to streamline their workflows and reuse established scripts, minimizing the need for repetitive coding and ensuring consistency across different projects.
Advanced Functionalities
The wrapper supports advanced capabilities such as the ability to pass JSON configurations to Blender scripts, allowing for dynamic adjustments based on user-defined parameters. This flexibility is particularly beneficial for tasks that require varying settings, such as adjusting decimation ratios or other mesh properties based on specific project needs.
Practical Benefits
By integrating Blender into the ComfyUI environment, this tool enhances workflow efficiency, giving users greater control over asset processing tasks. It allows for quick iterations on complex operations, improving the quality of outputs while reducing the time spent on manual adjustments and repetitive script writing.
Credits/Acknowledgments
The original development of this tool includes contributions from Kijai, whose Hunyuan wrapper has been adapted for better compatibility with Windows systems. The repository operates under a license that retains all rights with the original authors, ensuring proper attribution for their work.