Nodos OmniChar para ComfyUI: un archivo .char para H3, FLUX.2 y Krea 2
OmniChar lanza nodos oficiales para ComfyUI que cargan un archivo .char portátil y reutilizan la identidad de un personaje en MiniMax H3, FLUX.2 y Krea 2.
.char portátil que contiene las imágenes de referencia de un personaje, una descripción bloqueada y, cuando existe, un LoRA entrenado; después introduce esa identidad en modelos de imagen y vídeo desde dentro de un gráfico normal. El paquete indica soporte para MiniMax H3, Krea 2, FLUX.2 dev y FLUX.2 Klein 9B / 4B.
Los nodos OmniChar en el lienzo: Load Character, Decode Character y los nodos de referencia que entregan un personaje resuelto a un muestreador.
Qué contiene un archivo .char
Un .char describe un personaje, no una imagen. Conserva las fotos de referencia, la descripción vinculada a ellas y, por lo general, un LoRA entrenado, de modo que la misma persona se puede reconstruir en cualquier modelo que acepte referencias. Los personajes se guardan en ComfyUI/models/characters/, y el cargador simplemente lista lo que haya en esa carpeta.
Las referencias se agrupan por rol. Encode Character ordena las tomas de rostro, cuerpo y ropa en tres ranuras cada una, así que el rostro siempre es la primera referencia y la numeración del prompt sigue ese orden. Decode Character convierte el archivo de nuevo en un prompt más una lista de referencias resuelta, que es lo que realmente ve un muestreador.
Los nodos
| Nodo | Entradas | Salidas |
|---|---|---|
| Load Character | char, char_path | char |
| Decode Character | char, style, clip, prompt, arch, max_references, size_from, fit | conditioning, references, refs, sheet, prompt |
| Character Reference | refs, index | image, role, count |
| Character References Split | refs | image_0 a image_4, count |
| Character Reference Latent | conditioning, refs, vae | conditioning |
| Apply Character LoRA | model, clip, char, strength, arch, min_key_coverage | model, clip |
| Encode Character | name, description, resolution, face/body/cloths (tres ranuras cada uno) | char |
| Save Character | char, filename, overwrite | path |
La forma de entregar las referencias depende del modelo. Los modelos que aceptan un único lote leen references. Los modelos con ranuras de referencia numeradas, entre ellos MiniMax H3, dividen refs mediante un nodo Character References Split o un nodo Character Reference por ranura. Los modelos de edición que leen las referencias como latentes, por ejemplo FLUX.2, pasan refs a un nodo Character Reference Latent conectado tanto al acondicionamiento positivo como al negativo.
Flujos de trabajo incluidos en el paquete
El repositorio incluye tres gráficos de ejemplo: uno para crear un .char a partir de referencias de rostro, cuerpo y vestuario, otro que lleva FLUX.2 Klein 9B a una imagen y otro que lleva MiniMax H3 a un vídeo.
El ejemplo de identidad de referencia con MiniMax H3: ranuras de referencia separadas a la izquierda, la toma generada a la derecha.
Instalar
El paquete necesita ComfyUI y Python 3.10 o superior, y obtiene su lector de requirements.txt.
cd ComfyUI/custom_nodes
git clone https://github.com/omnichar/ComfyUI-Omnichar
cd ComfyUI-Omnichar
pip install -r requirements.txtReinicia ComfyUI después y busca Character en el menú de nodos. Si apuntas INLINE_CHARACTERS_DIR a la carpeta de personajes de OmniChar Studio, tanto el estudio como los nodos leen los mismos archivos .char.
Disponibilidad
Paquete de nodos: omnichar/ComfyUI-Omnichar
Aplicación Studio: omnichar/OmniChar
Sitio web: omnichar.org
Python SDK: pip install omnichar-sdk
Modelos base: Comfy-Org/MiniMax-H3, black-forest-labs/FLUX.2-klein-9b
Comentarios
Inicia sesión con GitHub para unirte a la conversación.