Terminal
Terminal/Skill
Trains a Soul Character, a personal face model that keeps your likeness consistent across generated images and videos.
By Higgsfield AI
Works with
npx skills add higgsfield-ai/skills --skill higgsfield-soul-idTrain a face-faithful identity model. Reusable across all Soul-powered generations.
Before any other command:
higgsfield is not on $PATH, install it:
curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.higgsfield account status shows free plan, tell the user before submitting.--image accepts either.--soul-2 — for image generation (default)--soul-cinematic — for cinematic / video work
Choose based on user's stated downstream use. Default to --soul-2.higgsfield soul-id create --name "<name>" --soul-2 --image ./photo1.png --image ./photo2.png ...
higgsfield soul-id create --name "<name>" --soul-2 --image <upload_id> --image <upload_id> ...
CLI auto-uploads paths. Captures returned reference id.higgsfield soul-id wait <id>. Silent. Default timeout 30m.<name> ready. Use in generate with --soul-id <id>."Once trained, pass to higgsfield-generate:
higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --quality 2k --wait
higgsfield generate create soul_cinematic --prompt "..." --soul-id <ref_id> --quality 2k --wait
--soul-id is sent as the model's custom_reference_id. For a curated Soul style, list styles with higgsfield preset list soul-v2 and pass the chosen id as --style_id on text2image_soul_v2. --style_id cannot be combined with --image.
higgsfield soul-id list # all references
higgsfield soul-id get <id> # one by id
Minimum Basic plan required — user is on free plan; tell them.Training failed — check photos quality (5+ unique faces, well-lit).Session expired → higgsfield auth login.references/photo-guide.md — what photos work bestreferences/troubleshooting.md — common training failures