Communitygithub.com

adamroy13/ai-influencer-promo-machine

Trainieren Sie eine Soul Character – ein personalisiertes Modell des Gesichts einer Person, das Higgsfield für identitätstreue Bild- und Videoerstellung verwendet.

Was ist ai-influencer-promo-machine?

Diese KI-Agentenfähigkeit ermöglicht es, eine identitätstreue digitale Repräsentation einer Person (eine sogenannte Soul Character) zu trainieren, die dann für die Erstellung von Bildern und Videos mit Higgsfield verwendet werden kann. Der Trainingsprozess ist ein einmaliger Vorgang, der eine Referenz-ID zurückgibt. Anschließend kann diese ID in `higgsfield-generate` mit speziellen Modellen wie `text2image_soul_v2` oder `soul_cinema_studio` verwendet werden. Die Fähigkeit unterstützt lokale Dateipfade oder bereits hochgeladene Upload-IDs für Fotos, fragt nach einem Namen und einer geeigneten Modellvariante (`--soul-2` oder `--soul-cinematic`) und wartet still, bis das Training abgeschlossen ist. Sie eignet sich nicht für einmalige Gesichtstausche (dafür gibt es das `--image`-Flag) oder nicht-fotorealistische Avatare.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adamroy13/ai-influencer-promo-machine/tree/HEAD/.agents/skills/higgsfield-soul-id

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Higgsfield Soul Character

Trainieren Sie ein gesichtstreues Identitätsmodell. Wiederverwendbar bei allen Soul-gestützten Generierungen.

Schritt 0 – Bootstrap

Vor jedem anderen Befehl:

  1. Falls higgsfield nicht im $PATH ist, installieren Sie es:
    curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh
    
  2. Falls higgsfield account status mit „Session expired“ / „Not authenticated“ fehlschlägt, bitten Sie den Benutzer, higgsfield auth login (interaktiv) auszuführen, und warten Sie auf die Bestätigung.
  3. Soul-Training erfordert einen kostenpflichtigen Tarif (Basic+). Falls higgsfield account status einen kostenlosen Tarif anzeigt, informieren Sie den Benutzer vor dem Absenden.

UX-Regeln

  1. Seien Sie prägnant. Keine rohen IDs im Chat. Sagen Sie einfach „Soul bereit“ mit einer Namensreferenz.
  2. Erkennen Sie die Sprache und antworten Sie darin. CLI-Flags bleiben auf Englisch.
  3. Fragen Sie nach der kleinsten Menge an Eingaben: Name + Fotos. Wählen Sie eine sinnvolle Modellvariante.
  4. Polling erfolgt still – das Training dauert Minuten. Wiederholen Sie keine Statusaktualisierungen.

Arbeitsablauf

  1. Namen abfragen. Ein Wort, das später zur Referenz verwendet wird. Fragen Sie, falls er fehlt.
  2. Fotos holen. 5–20 Gesichtsfotos mit verschiedenen Winkeln und Lichtverhältnissen. Lokale Pfade oder bereits hochgeladene IDs funktionieren beide – --image akzeptiert beides.
  3. Variante wählen.
    • --soul-2 – für Bildgenerierung (Standard)
    • --soul-cinematic – für filmische / Video-Arbeiten Wählen Sie basierend auf dem vom Benutzer angegebenen Downstream-Einsatz. Standardmäßig --soul-2.
  4. Absenden.
    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> ...
    
    Die CLI lädt Pfade automatisch hoch. Erfasst die zurückgegebene Referenz-ID.
  5. Warten. higgsfield soul-id wait <id>. Still. Standard-Timeout 30m.
  6. Ausliefern. „Soul <name> bereit. Verwenden Sie in generate mit --soul-id <id>.“

Soul verwenden

Nach dem Training an higgsfield-generate übergeben:

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

Vorhandene Souls auflisten

higgsfield soul-id list                   # alle Referenzen
higgsfield soul-id get <id>               # eine nach ID

Fehler

  • Minimum Basic plan required – Der Benutzer hat einen kostenlosen Tarif; informieren Sie ihn.
  • Training failed – Überprüfen Sie die Fotoqualität (5+ eindeutige Gesichter, gut beleuchtet).
  • Session expired → higgsfield auth login.

Referenzdokumente

  • references/photo-guide.md – welche Fotos am besten funktionieren
  • references/troubleshooting.md – häufige Trainingsfehler

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

adamroy13/ai-influencer-promo-machine

A 5-stage AI content pipeline using Higgsfield MCP, focused on viral UGC content split evenly across 5 formats: UGC Entertainment (challenges), Street Interview, Unboxing, Product Review, ASMR. Button-driven UX — clicks, no typed commands. Stage 1: probe Marketing Studio capability, research trends in the product's niche on Instagram, TikTok, YouTube, and turn them into prompts mapped to the 5 formats with picklist hooks. Stage 2: produce one HTML video content plan; user sets the count, the skill divides evenly across the 5 formats. Stage 3: generate videos one format batch at a time, then auto-generate the image asset pack via GPT Image 2.0. Stage 4: schedule to Meta Ads via Meta MCP. Stage 5: render a cost comparison — Higgsfield credits + USD spent vs traditional production cost. Trigger on a product image + content request, or phrases like 'create a campaign', 'build a content plan', 'make videos in Higgsfield', 'generate the image pack', 'schedule to Meta', 'run the content pipeline'.

adamroy13/ai-influencer-promo-machine

Generate images/videos via Higgsfield AI. Default: GPT Image 2 for images/design/text, Seedance 2.0 for video, Nano Banana 2/Pro for character/reference image work, Marketing Studio for ads with avatars/products/hooks, settings, plus Soul V2/Cinema/Cast/Location and Kling 3.0. Use when: "generate an image", "make a video", "animate this photo", "image-to-video", "edit/stylize/remix this image", "produce a clip", "create an ad", "make a UGC video", "product demo", "unboxing", "brand video", "presenter video", "import product from URL", "create avatar for ad", or "analyze video virality". Supports image-to-image, image-to-video, references, job/upload IDs, and Marketing Studio. Chain with higgsfield-soul-id for face/identity consistency. Virality Predictor (`brain_activity`) analyzes video virality: hook strength, attention, retention, distraction risk, and creative score. NOT for: Soul Character training (use higgsfield-soul-id), product photoshoots, marketplace listing cards, text/chat/TTS tasks.

adamroy13/ai-influencer-promo-machine

Generate marketplace product image cards through Higgsfield: compliant main image, secondary product images, and A+ style content modules. Use when the user asks for marketplace listing images, product detail cards, secondary product images, product infographics, lifestyle listing shots, A+ style content, marketplace image sets, or sales-ready product visuals. Backend owns marketplace compliance references and prompt templates; this skill only routes user intent to the CLI. NOT for generic brand product photography without marketplace/listing context (use higgsfield-product-photoshoot), video generation or UGC ads (use higgsfield-generate), or Soul Character training (use higgsfield-soul-id).

adamroy13/ai-influencer-promo-machine

Generate brand-quality product images through Higgsfield product-photoshoot prompt enhancement on GPT Image 2 / gpt_image_2. Entry point for professional brand/product visuals. Use when: "product photo", "studio shot", "lifestyle image", "Pinterest pin", "hero/banner", "carousel", "ad creative", "Meta ads", "virtual try-on", "model wearing", "person holding product", "closeup with hands", "levitating/floating/splash product", "CGI/surreal product", "restyle", "seasonal/aesthetic variation", or any product, brand, or paid-social creative. Modes: product_shot, lifestyle_scene, closeup_product_with_person, moodboard_pin, hero_banner, social_carousel, ad_creative_pack, virtual_model_tryout, conceptual_product, restyle. Backend assembles the final prompt; never freehand it. NOT for: no-product text-to-image (use higgsfield-generate), branded avatar video (use higgsfield-generate Marketing Studio), marketplace listing cards (use higgsfield-marketplace-cards), Soul Character training (use higgsfield-soul-id).

Verwandte Skills