higgsfield-soul-id

higgsfield-soul-id

Higgsfield Soul Character

Train a face-faithful identity model. Reusable across all Soul-powered generations.

Step 0 — Bootstrap

Before any other command:

• If higgsfield is not on $PATH, install it:

curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

• If higgsfield account status fails with Session expired / Not authenticated, ask the user to run higgsfield auth login (interactive) and wait for confirmation.

• Soul training requires a paid plan (Basic+). If higgsfield account status shows free plan, tell the user before submitting.

UX Rules

• Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.

• Detect language and respond in it. CLI flags stay English.

• Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.

• Polling is silent — training takes minutes. Don't repeat status updates.

Workflow

• Get name. One word, used for later reference. Ask if missing.

• Get photos. 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work — --image accepts either.

• Pick variant.

--soul-2 — for image generation (default)

• --soul-cinematic — for cinematic / video work Choose based on user's stated downstream use. Default to --soul-2.

• Submit.

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.

• Wait. higgsfield soul-id wait <id>. Silent. Default timeout 30m.

• Deliver. "Soul <name> ready. Use in generate with --soul-id <id>."

Use the Soul

Once trained, pass to higgsfield-generate:

higgsfield generate create text2image_soul_v2 --prompt "..." --soul-id <ref_id> --wait
higgsfield generate create soul_cinema_studio --prompt "..." --soul-id <ref_id> --wait

Listing existing Souls

higgsfield soul-id list                   # all references
higgsfield soul-id get <id>               # one by id

Errors

• 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.

Reference docs

• references/photo-guide.md — what photos work best

• references/troubleshooting.md — common training failures

Weekly Installs2.4KRepositoryhiggsfield-ai/skillsGitHub Stars45First Seen1 day agoSecurity AuditsGen Agent Trust HubPassSocketPassSnykFail