Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-GNM > GNM Identity Sampler

ComfyUI Node: GNM Identity Sampler

Class Name

GNMIdentitySampler

Category
GNM
Author
soylab-edu (Account age: 149days)
Extension
ComfyUI-GNM
Latest Updated
2026-07-16
Github Stars
0.01K

How to Install ComfyUI-GNM

Install this extension via the ComfyUI Manager by searching for ComfyUI-GNM
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-GNM in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

GNM Identity Sampler Description

Samples repeatable GNM 3D head identity vectors by gender and ethnicity, with adjustable strength.

GNM Identity Sampler:

GNMIdentitySampler creates a sampled identity for Google's GNM parametric 3D head model using its semantic identity sampler. It draws a variation associated with a selected gender and ethnicity category, then lets you control how strongly that variation affects the identity vector. This gives you a way to explore different head shapes while keeping a chosen sample repeatable. The node produces model parameters, not a rendered image; a compatible GNM rendering node can turn them into a visible head.

GNM Identity Sampler Input Parameters:

gender

Selects the gender category used by the semantic sampler. The available options are female and male. This choice affects which category the identity variation is sampled from; it does not specify an exact appearance. No default option is stated in the supplied node interface.

ethnicity

Selects the ethnicity category used by the semantic sampler. The available options are middle_eastern, asian, white, and black. The sampler uses this category together with the gender selection to produce an identity variation. These are model category labels, not guarantees about how any rendered face will look. No default option is stated in the supplied node interface.

strength

Controls the magnitude of the sampled identity variation. The sampler multiplies the generated vector by this value: 0.0 produces a zero identity vector, while higher values increase the variation from that zero vector. The default is 1.0; the minimum is 0.0, the maximum is 3.0, and the interface step is 0.05. A high value changes the size of the variation, but does not guarantee a particular visual result.

seed

Sets the random seed used to generate the sample. Keep the same seed, gender, ethnicity, and strength to reproduce the same identity vector; change the seed to explore another variation within the selected categories. The default is 0; the minimum is 0 and the maximum is 18446744073709551615.

GNM Identity Sampler Output Parameters:

identity

A GNM_IDENTITY vector containing the sampled head-identity parameters after strength has been applied. It is not an image or a text description. Connect it to the optional identity input of a compatible node such as GNMHeadRender to see the resulting head. The vector represents one sampled variation, so its values should be interpreted as model parameters rather than as individual, named facial features.

GNM Identity Sampler Usage Tips:

  • Start with strength at its default of 1.0. Hold the categories and seed fixed while adjusting strength to compare the same sampled variation at different magnitudes.
  • Change only seed when you want another identity within the same selected categories. Record the seed and settings for a result you want to reproduce.
  • Set strength to 0.0 when you need a zero-vector identity for comparison. At this setting, changing the seed or categories will not change the output vector.
  • Connect identity to GNMHeadRender and keep its expression and camera settings consistent when comparing identities. This makes differences in the rendered heads easier to assess.

GNM Identity Sampler Common Errors and Solutions:

ValueError: '<value>' is not in list

  • Explanation: The sampler looks up gender and ethnicity in its supported option lists. This error can occur if a workflow passes a value that is not an exact match.
  • Solution: Select one of the options shown in the node interface. Check spelling and underscores in values such as middle_eastern.

ValueError: expected non-negative integer

  • Explanation: The random-number generator requires a valid seed. This error can occur if a negative seed is supplied outside the interface's allowed range.
  • Solution: Set seed to an integer from 0 through 18446744073709551615, preferably using the node's seed control.

identity has <number> dims, expected <number>

  • Explanation: This message comes from GNMHeadRender, not GNMIdentitySampler. It means the renderer received an identity vector whose length does not match its loaded GNM model.
  • Solution: Connect this node's identity output directly to a compatible GNM renderer and avoid substituting or altering the vector with incompatible nodes.

No visible difference after changing the seed or categories

  • Explanation: If strength is 0.0, every sampled vector is multiplied by zero. A disconnected identity output also cannot affect a downstream render.
  • Solution: Set strength above 0.0, confirm that identity is connected to the renderer, and render again.

GNM Identity Sampler Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-GNM
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

GNM Identity Sampler