gitwtfhub

wtf is gnm-head-add-on-for-blender?

derqwertzus/gnm-head-add-on-for-blender — explained in plain English

Analysis updated 2026-05-18

17PythonAudience · designerComplexity · 3/5LicenseSetup · moderate

TL;DR

A Blender add-on that generates and sculpts realistic human heads using Google's GNM model, with sliders for identity, expression, and region-masked edits.

Mindmap

mindmap
  root((GNM Head Add-on))
    What it does
      Generates human heads
      Blends identity traits
      Applies facial expressions
      Region-masked randomization
    Tech stack
      Python
      Blender
      NumPy
      Flask server
    Use cases
      Sculpt character heads
      Randomize facial features
      Bake identity variants
      Paint custom edit masks
    Audience
      3D artists
      Character designers
      Blender hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate a base human head for a 3D character by blending gender and ethnicity sliders.

REASON 2

Apply one of twenty facial expressions with adjustable intensity to a head.

REASON 3

Randomize only the eyes or mouth of a head using a painted region mask.

REASON 4

Bake a finished head into an independent object before generating new variations.

What's in the stack?

PythonBlenderNumPyFlaskh5py

How it stacks up

derqwertzus/gnm-head-add-on-for-blender0petru/sentimoagi-eval-official/forte
Stars171717
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencedesignerdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Blender 4.2+, a system Python 3.10-3.12, and an internet connection for a one-time ~170MB environment download.

The add-on itself is under GPL, which requires derivative works to also share their source code, the underlying GNM model is separately licensed under the more permissive Apache-2.0.

Wtf does this do

This is a Blender add-on that lets you generate and sculpt realistic human heads using Google's GNM, or Generative Anthropometric Model, a system trained to produce plausible human head shapes. Instead of manually sculpting a face from scratch, you use sliders to blend traits like gender and ethnicity, choose from twenty facial expressions with adjustable intensity, and watch the head update live in the 3D viewport. A useful feature is region-masked randomization. Six preset masks cover areas like the eyes, nose, mouth, jaw, ears, and back of the head, and when one is active, randomizing the identity only changes that masked area while dimming the rest of the model so you can see exactly what is being edited. You can also paint and save your own custom masks. The generated heads use clean quad-based topology rather than a messy triangulated mesh, and you can toggle visibility of parts like eyes, teeth, tongue, and cornea shells, with hidden parts fully removed rather than just hidden. Once you land on a head you like, the Bake Identity feature copies it into an independent object so you can keep generating new variations without losing your saved ones. The add-on works by installing and running a small local server that handles the actual model computation using NumPy rather than TensorFlow, keeping the whole setup around 170 megabytes. To use it, you need Blender 4.2 or newer and a system Python between versions 3.10 and 3.12 available on your computer, plus an internet connection for the one-time setup where the add-on downloads the GNM model and its dependencies. Installation is done by downloading the extension file from the Releases page and installing it through Blender's extension manager, then clicking Install Environment inside the add-on's preferences.

Yoink these prompts

Prompt 1
Walk me through installing the GNM Head add-on and setting up its environment in Blender.
Prompt 2
Explain how region-masked randomization works in the GNM Head add-on.
Prompt 3
Show me how to bake an identity so I don't lose it when generating new heads.
Prompt 4
How do I paint and save my own custom mask region for this add-on?
Prompt 5
What Blender and Python versions do I need to run this add-on?

Frequently asked questions

wtf is gnm-head-add-on-for-blender?

A Blender add-on that generates and sculpts realistic human heads using Google's GNM model, with sliders for identity, expression, and region-masked edits.

What language is gnm-head-add-on-for-blender written in?

Mainly Python. The stack also includes Python, Blender, NumPy.

What license does gnm-head-add-on-for-blender use?

The add-on itself is under GPL, which requires derivative works to also share their source code, the underlying GNM model is separately licensed under the more permissive Apache-2.0.

How hard is gnm-head-add-on-for-blender to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gnm-head-add-on-for-blender for?

Mainly designer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.