higgsfield-soul-id

Installation

Summary

Train a reusable face identity model for personalized image and video generation.

Requires 5–20 face photos from varied angles and lighting; accepts local file paths or pre-uploaded image IDs
Two model variants: --soul-2 for image generation (default) and --soul-cinematic for video work
Returns a reference ID after training completes, then pass to higgsfield-generate with --soul-id flag to generate identity-faithful content
Requires paid plan (Basic+) and authenticated session via higgsfield auth login

SKILL.md

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.

Installs

55.8K

Repository

GitHub Stars

481

First Seen

May 4, 2026

Security Audits