What makes Higgsfield Soul ID notable?

1K downloads. Trust evidence available

How should Higgsfield Soul ID be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Higgsfield Soul ID

Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my... Skill: Higgsfield Soul ID Owner: higgsfield Summary: Train a Soul Character — a personalized model on a person's face that Higgsfield uses for identity-faithful image and video generation. Use when: "create my... Tags: latest:1.0.0 Version history: v1.0.0 | 2026-05-04T16:21:46.039Z | user Initial release enabling personalized Soul Character training for identity-faithful image and video generation. - Allows users to

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.0release · observed May 4, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17f8fwnpnszqskag8vjqhx1ts862976:higgsfield-soul-id

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-higgsfield-higgsfield-soul-id/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

8,063 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
version: 0.3.0
name: higgsfield-soul-id
description: |
  Train a Soul Character — a personalized model on a person's face that
  Higgsfield uses for identity-faithful image and video generation.
  Use when: "create my Soul", "train my face", "make my digital twin",
  "build me an avatar", "learn my appearance", "create a character of me",
  "set up identity for video", "I want my face in generated images".
  Chain: train Soul (one-time, returns reference_id) → use in
  higgsfield-generate via `--soul-id <id>` with models like
  `text2image_soul_v2` or `soul_cinema_studio`.
  NOT for: one-shot face swaps (use higgsfield-generate with --image),
  named-character / non-photo avatars (use higgsfield-generate with prompt).
argument-hint: "[name] [photo paths...]"
allowed-tools: Bash
---

# Higgsfield Soul Character

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

## Step 0 — Bootstrap

Before any other command:

1. If `higgsfield` is not on `$PATH`, install it:
   ```bash
   curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
   ```
2. If `higgsfield account status` fails with `Session expired` / `Not authenticated`, ask the user to run `higgsfield auth login` (interactive) and wait for confirmation.
3. Soul training requires a paid plan (Basic+). If `higgsfield account status` shows free plan, tell the user before submitting.

## UX Rules

1. Be concise. No raw IDs in chat. Just say "Soul ready" with a name reference.
2. Detect language and respond in it. CLI flags stay English.
3. Ask for the smallest set of inputs: name + photos. Pick a sensible model variant.
4. Polling is silent — training takes minutes. Don't repeat status updates.

## Workflow

1. **Get name.** One word, used for later reference. Ask if missing.
2. **Get photos.** 5–20 face photos, varied angles and lighting. Local paths or already-uploaded IDs both work — `--image` accepts either.
3. **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`.
4. **Submit.**
   ```bash
   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.
5. **Wait.** `higgsfield soul-id wait <id>`. Silent. Default timeout 30m.
6. **Deliver.** "Soul `<name>` ready. Use in generate with `--soul-id <id>`."

## Use the Soul

Once trained, pass to `higgsfield-generate`:

```bash
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

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

##

_meta.json

{
  "ownerId": "kn75nbcv2e6k6p0qdc2tkn0dvn862nys",
  "slug": "higgsfield-soul-id",
  "version": "1.0.0",
  "publishedAt": 1777911706039
}

references/photo-guide.md

# Photo Guide

What to upload for Soul training.

## Quantity

- Minimum 5, maximum 20.
- 8–12 is the sweet spot.

## Content

- Clear face, eyes visible.
- Single person per photo.
- No heavy filters, no sunglasses.

## Variety

Higher variety = better identity capture.

- Multiple angles: front, 3/4 left, 3/4 right, slight up/down.
- Different lighting: indoor, outdoor, soft, harsh.
- Different expressions: neutral, smiling, talking.
- Different distances: head shot, head-and-shoulders, full body.

## Quality

- Sharp, in-focus.
- Resolution ≥ 1024×1024 ideal.
- JPEG or PNG.

## Avoid

- Group photos.
- Heavy makeup not normally worn.
- Costumes / cosplay.
- Hats covering the face.
- Same pose repeated.

references/troubleshooting.md

# Soul Troubleshooting

## `Minimum Basic plan required`

Soul training needs a paid plan. Tell the user to upgrade.

## `Training failed`

Common causes:

- Too few photos (<5) or too uniform.
- Heavy occlusion (sunglasses, hats).
- Group photos confusing identity.
- Upload type mismatch (must be image uploads, not video).

Action: ask user to swap in better photos, retrain.

## `Session expired`

`higgsfield auth login`.

## Slow training

Default timeout is 30m. If still in progress: `higgsfield soul-id wait <id> --timeout 60m`.

skill-card.md

## Description:

Trains a reusable Higgsfield Soul Character from face photos for identity-faithful image and video generation.

This skill is ready for commercial/non-commercial use.

## Publisher:

[higgsfield](https://clawhub.ai/user/higgsfield)

### License/Terms of Use:

MIT-0

## Use Case:

External users and creators use this skill to prepare face-photo inputs, train a personalized Higgsfield Soul model, and use the returned Soul ID in later Higgsfield image or cinematic generation workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill asks the agent to install the Higgsfield CLI through a remote installer command.

Mitigation: Review the installer source before execution and prefer a pinned, verified release or official package path.

Risk: The workflow uploads face photos to create a reusable identity model.

Mitigation: Use only photos the user has the right to upload and confirm explicit comfort with sending those photos to Higgsfield before training.

Risk: Training may proceed without enough privacy, consent, or account-plan clarity.

Mitigation: Confirm the authenticated account, paid-plan requirement, and intended downstream use before submitting a training job.

## Reference(s):

- [Photo Guide](references/photo-guide.md)
- [Soul Troubleshooting](references/troubleshooting.md)
- [ClawHub Skill Page](https://clawhub.ai/higgsfield/skills/higgsfield-soul-id)

## Skill Output:

**Output Type(s):** [Text, Shell commands, Guidance]

**Output Format:** [Markdown with inline bash code blocks]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include Higgsfield CLI commands, account or plan checks, photo quality guidance, and a reusable Soul ID after training completes.]

## Skill Version(s):

1.0.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.