higgsfield-soul-id

Trains a face-faithful Soul identity model on Higgsfield for image and video generation.

1|Updated Jul 19, 2026
One-click install
npx skills add https://github.com/leobbaroni/maestro --skill higgsfield-soul-id-leobbaroni
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: higgsfield-soul-id
Source: https://github.com/leobbaroni/maestro/tree/main/skills/maestro/library/higgsfield-skills/higgsfield-soul-id
Command: npx skills add https://github.com/leobbaroni/maestro --skill higgsfield-soul-id-leobbaroni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating consistent, identity-faithful images and videos of a real person with generative AI requires a trained identity model, and the training workflow involves CLI setup, authentication, photo selection, and long-running job polling that is easy to get wrong. ## Core Features & Use Cases - Soul Character Training: Submits 5-20 face photos to Higgsfield to train a reusable identity model, returning a reference ID for all future generations. - Variant Selection: Chooses between the image-focused soul-2 variant and the cinematic soul-cinematic variant based on the intended downstream use. - Guided Photo & Troubleshooting References: Includes a photo guide covering quantity, angles, lighting, and quality, plus troubleshooting for plan limits, training failures, and expired sessions. - Use Case: A creator wants their own face in AI-generated cinematic videos. They provide a name and ten varied photos; the Skill trains the Soul, waits for completion, and hands back a reference ID usable with higgsfield-generate via --soul-id. ## Quick Start Train a Soul character named alex using the face photos in my photos folder so I can use my identity in Higgsfield generations.

Frequently Asked Questions about higgsfield-soul-id

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I train a face model for AI image generation with Higgsfield?▼

Run higgsfield soul-id create with a name, a variant flag, and 5-20 face photos. The CLI uploads the images, trains the Soul model, and returns a reference ID you pass to higgsfield-generate with --soul-id.

What photos work best for Higgsfield Soul training?▼

Use 8-12 sharp photos of a single person with varied angles, lighting, expressions, and distances. Avoid group photos, sunglasses, heavy filters, costumes, and repeated poses, as these reduce identity capture quality.

Does Higgsfield Soul training require a paid plan?▼

Yes, Soul training requires a Basic plan or higher. If higgsfield account status shows a free plan, the create command fails with a Minimum Basic plan required error and the user must upgrade first.

What is the difference between soul-2 and soul-cinematic variants?▼

The soul-2 variant is the default and targets image generation, while soul-cinematic is tuned for cinematic and video work. Choose based on the stated downstream use of the trained identity.

Why did my Higgsfield Soul training fail?▼

Training usually fails due to fewer than five photos, uniform or occluded faces such as sunglasses or hats, group photos, or non-image uploads. Swap in better varied photos and retrain.

When should I use Soul training instead of a one-shot face swap?▼

Use Soul training when you need a reusable, identity-faithful model across many generations. For a single face swap, use higgsfield-generate with --image instead, and for non-photo characters use a text prompt.