Skip to content

Releases: huggingface/meshgen

v0.3.1

23 Dec 17:50
e5b82e1
Compare
Choose a tag to compare

This release includes support for Ollama server and additional release architectures.

Thanks to:

Before installing, uninstall any previous release, then restart Blender.

Installation

Windows/Mac/Linux (CPU)

This version is slow, but supports more devices. If you meet the requirements, the GPU version is recommended.

Requirements

Steps

  • Download meshgen-cpu-{platform}.zip in Assets below, depending on your platform
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click the arrow in the top right then Install from Disk
  • Choose meshgen-cpu-{platform}.zip
  • In addon preferences, click Download Required Models

Windows/Linux (NVIDIA GPU)

This version is much faster, but requires a high-end NVIDIA GPU.

Requirements

Steps

  • Download meshgen-cuda-{platform}.zip in Assets below, depending on your platform
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click arrow in the top right then Install from Disk
  • Choose meshgen-cuda-{platform}.zip
  • In addon preferences, click Download Required Models

Usage

  • Press N -> MeshGen (or View -> Sidebar -> Select the MeshGen tab)
  • Click Load Generator (this will take a while)
  • Enter a prompt, for example: Create a 3D obj file using the following description: a desk
  • Click Generate Mesh

Troubleshooting

  • Find errors in the console:
    • Windows: In Blender, go to Window -> Toggle System Console
    • Mac/Linux: Launch Blender from the terminal
  • Report errors in Issues

v0.3.0

03 Dec 18:54
e6500f8
Compare
Choose a tag to compare

This release dramatically improves performance and memory requirements. It does so by replacing the transformers backend and full model with a llama-cpp-python backend and quantized model.

Before installing, uninstall any previous release, then restart Blender.

Installation

Windows/Mac/Linux (CPU)

This version is slow, but supports more devices. If you meet the requirements, the GPU version is recommended.

Requirements

Steps

  • Download meshgen-cpu.zip in Assets below
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click the arrow in the top right then Install from Disk
  • Choose meshgen-cpu.zip
  • In addon preferences, click Download Required Models

Windows/Linux (NVIDIA GPU)

This version is much faster, but requires a high-end NVIDIA GPU.

Requirements

Steps

  • Download meshgen-cuda.zip in Assets below
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click arrow in the top right then Install from Disk
  • Choose meshgen-cuda.zip
  • In addon preferences, click Download Required Models

Usage

  • Press N -> MeshGen (or View -> Sidebar -> Select the MeshGen tab)
  • Click Load Generator (this will take a while)
  • Enter a prompt, for example: Create a 3D obj file using the following description: a desk
  • Click Generate Mesh

Troubleshooting

  • Find errors in the console:
    • Windows: In Blender, go to Window -> Toggle System Console
    • Mac/Linux: Launch Blender from the terminal
  • Report errors in Issues

v0.1.0

27 Nov 20:18
Compare
Choose a tag to compare

This initial release contains a minimal integration of LLaMa-Mesh in Blender.

Installation

Windows/Linux

Requirements

Steps

  • Download meshgen-win-linux-cuda.7z in Assets below
  • Right click -> Show more options -> 7-Zip -> Extract Here to extract the meshgen.zip file
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click arrow in the top right then Install from Disk
  • Choose meshgen.zip

Mac (untested)

Requirements

Steps

  • Download meshgen-macos-arm.zip in Assets below
  • Extract the contained meshgen.zip file
  • In Blender, go to Edit -> Preferences -> Add-ons -> Click arrow in the top right then Install from Disk
  • Choose meshgen.zip

Setup

  • In MeshGen addon preferences, click Download Required Models
  • If set up correctly, addon preferences should display the message `Ready to generate. Press 'N' -> MeshGen to get started.'

Usage

  • Press N -> MeshGen
  • Click Load Generator (this will take a while)
  • Enter a prompt, for example: Create a 3D obj file using the following description: a desk
  • Click Generate Mesh

Troubleshooting

  • Find errors in the console:
    • Windows: In Blender, go to Window -> Toggle System Console
    • Mac/Linux: Launch Blender from the terminal
  • Report errors in Issues