85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
# ComfyUI-GeometryPack
|
|
|
|
Professional geometry processing nodes for ComfyUI. Load, analyze, remesh, unwrap, and visualize 3D meshes directly in your workflows.
|
|
|
|
**[View Workflow Gallery](https://pozzettiandrea.github.io/ComfyUI-GeometryPack/)**
|
|
|
|
|
|
## Some previews
|
|
|
|
https://github.com/user-attachments/assets/c2e393ba-fb57-4a46-b772-31c4b01f47f8
|
|
|
|
|
|
https://github.com/user-attachments/assets/b1bcd570-719f-4be5-868d-f72c9f1f4c10
|
|
|
|
|
|
https://github.com/user-attachments/assets/607e6b29-a8d4-4346-873a-5bd6b140bdba
|
|
|
|
|
|
https://github.com/user-attachments/assets/7718a5d7-cd5b-47d3-874c-29ada4320694
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
cd ComfyUI/custom_nodes/
|
|
git clone https://github.com/PozzettiAndrea/ComfyUI-GeometryPack.git
|
|
cd ComfyUI-GeometryPack
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
**Automatic Blender Installation (Recommended):**
|
|
```bash
|
|
python install.py
|
|
```
|
|
|
|
This will automatically download and install a portable version of Blender for UV unwrapping and remeshing nodes. No admin rights required!
|
|
|
|
Restart ComfyUI. Nodes appear in the `geompack/` category.
|
|
|
|
**Optional Dependencies:**
|
|
- **Blender**: Auto-installed via `install.py`, or install manually from [blender.org](https://www.blender.org/download/)
|
|
- **CGAL**: Build tools for CGAL remeshing (see `cgal_tools/README.md`)
|
|
|
|
## Quick Start
|
|
|
|
**Basic workflow:**
|
|
```
|
|
Create Primitive → Mesh Info → Preview Mesh (3D)
|
|
Load Mesh → PyMeshLab Remesh → Save Mesh
|
|
```
|
|
|
|
## Community
|
|
|
|
Questions or feature requests? Open a [Discussion](https://github.com/PozzettiAndrea/ComfyUI-GeometryPack/discussions) on GitHub.
|
|
|
|
Join the [Comfy3D Discord](https://discord.gg/bcdQCUjnHE) for help, updates, and chat about 3D workflows in ComfyUI.
|
|
|
|
## Credits
|
|
|
|
Built on [trimesh](https://trimesh.org/), [libigl](https://libigl.github.io/), [PyMeshLab](https://pymeshlab.readthedocs.io/), and [CGAL](https://www.cgal.org/).
|
|
|
|
## License
|
|
|
|
**GNU General Public License v3.0 or later (GPL-3.0-or-later)**
|
|
|
|
This project is licensed under the GPL-3.0-or-later license to ensure compatibility with the included dependencies:
|
|
|
|
- **Blender** (GPL-2.0-or-later) - Used for advanced UV unwrapping and remeshing
|
|
- **CGAL** (GPL-3.0-or-later) - Used for boolean operations and isotropic remeshing
|
|
- **PyMeshLab** (GPL-3.0) - Used for mesh processing operations
|
|
|
|
### What This Means
|
|
|
|
- ✅ You can use, modify, and distribute this software freely
|
|
- ✅ You can use it for commercial purposes
|
|
- ⚠️ If you distribute modified versions, you must also license them under GPL-3.0-or-later
|
|
- ⚠️ You must share the source code of any modifications you distribute
|
|
|
|
For more details, see:
|
|
- [LICENSE](LICENSE) - Full GPL-3.0 license text
|
|
- [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md) - Detailed third-party license information
|
|
|
|
### Questions?
|
|
|
|
If you have questions about licensing, please open an issue on [GitHub](https://github.com/PozzettiAndrea/ComfyUI-GeometryPack/issues).
|