FaceNinja

Návod · Claude Code · Codex · Cursor · Gemini CLI · OpenClaw

3D hlavy z Claude Code, Codexu nebo Cursoru.

Váš AI agent pro programování za vás může dělat hlavy MetaHuman: jednu hlavu z fotky, obsazení ze složky, soubory FBX pro všechny vaše hlavy nebo skript pro vaši pipeline. Tento návod projde první spuštění, na co se vás agent zeptá a co může a nemůže dělat.

První spuštění krok za krokem

  1. Vložte jeden prompt

    Otevřete agenta ve složce s fotkou a vložte tohle. Funguje to v každém agentovi, který umí spustit příkaz v shellu nebo stáhnout URL; stránka o agentech má verzi pro každého z nich.

    Prompt · angličtina
    Read https://faceninja.net/skill/SKILL.md and install the FaceNinja skill it describes. Then sign me in with it (it will show me a code to approve) and make a MetaHuman head from ./photo.jpg. Save the GLB and the MetaHuman ZIP in ./faceninja-out.

    Ponechte tento prompt v angličtině: váš agent potřebuje webovou adresu přesně tak, jak je napsaná. Pak s ním můžete mluvit svým jazykem.

  2. Schvalte přihlašovací kód

    Agent vám ukáže krátký kód a otevře faceninja.net/device. Tam se přihlásíte a kód schválíte. Do chatu se nevkládá žádný klíč API; skill si klíč drží na vašem počítači a nikdy ho nevypíše.

  3. Potvrďte, že fotky smíte použít

    Před první hlavou vám agent ukáže prohlášení, které potvrdíte vlastními slovy: máte právo fotky použít a souhlas každé osoby, jde o dospělé a dodržujete Zásady obsahu a podoby osob EN. Agent to nikdy nepotvrdí za vás.

  4. Agent nejdřív řekne cenu

    Zkontroluje váš zůstatek a řekne, kolik hlava stojí a kolik zbude, než cokoli utratí. U více než pěti hlav se zastaví a požádá vás o potvrzení celkové částky.

  5. Vyzkoušejte ukázky zdarma

    I bez jediného kreditu může agent stáhnout 20 ukázkových hlav, takže nejdřív otestujete zbytek své pipeline.

  6. Jedna hlava, pak složka

    Pro obsazení dejte fotky každé osoby do vlastní podsložky a vložte prompt pro obsazení. Agent hlavy spočítá, řekne celkovou částku a počká na vaše ano.

    Prompt · angličtina
    Read https://faceninja.net/skill/SKILL.md and use the FaceNinja skill. Every subfolder of ./cast is one person: make one MetaHuman head per subfolder from the photos inside it. Before you start, tell me the number of heads, the total cost and my balance, and wait for my yes. Save each head's FBX and MetaHuman ZIP in ./faceninja-out/<subfolder name>.

    Ponechte tento prompt v angličtině: váš agent potřebuje webovou adresu přesně tak, jak je napsaná. Pak s ním můžete mluvit svým jazykem.

Co skill spouští

Skill je jeden soubor v Pythonu bez balíčků k instalaci (Python 3.9 nebo novější). Spouští ho váš agent; můžete ho spustit i vy. Toto je jeho vlastní nápověda, bez úprav:

Shell
$ python3 faceninja.py --help
usage: faceninja.py [-h] [--json] [--base BASE] [--version] COMMAND ...

FaceNinja: photos in, MetaHuman head out.

positional arguments:
  COMMAND
    login      sign in by approving a code in the browser
    whoami     who is signed in
    balance    credits left and what a head costs
    make       make one head from 1-15 photos of one person
    status     where a head stands
    download   download a finished head's files
    batch      one head per photo, or per subfolder with --per-person-
               subfolders
    samples    the free sample heads: list them, or --download ID|all (no
               credits)
    list       your heads, newest first
    logout     revoke and forget the saved key
    update     update the skill now (it also updates itself at most hourly)
    guidance   the server's current rules and notices for agents
    attest     the user confirms, once per computer, that they may use the
               photos (asked before the first head)

options:
  -h, --help   show this help message and exit
  --json       one JSON object on stdout, progress on stderr
  --base BASE  API server (default $FACENINJA_API_BASE or
               https://faceninja.net)
  --version    show program's version number and exit

Co agent může a nemůže dělat

  • Dělat hlavy z 1–15 fotek jedné osoby, jednu hlavu na podsložku, a stahovat GLB, FBX, OBJ, STL, PLY nebo MetaHuman ZIP.
  • Kontrolovat váš zůstatek, vypsat vaše hlavy a znovu je stáhnout.
  • Napsat skript pipeline s idempotentními klíči a obsluhou webhooků, podle llms.txt a skillu.
  • Kupovat kredity ani zapínat automatické dobíjení: místo toho vás pošle do webové aplikace.
  • Potvrzovat souhlas ani schvalovat přihlášení za vás.
  • Dělat hlavy dětí, veřejně známých osob ani z fotek nalezených na internetu.

Otázky k hlavám z AI agentů

01Kteří agenti fungují?
Claude Code, Codex, Cursor, Gemini CLI a OpenClaw a každý agent, který umí spustit příkaz v shellu nebo stáhnout URL.
02Vkládám do chatu klíč API?
Ne. Schválíte kód v prohlížeči a skill si klíč drží na vašem počítači. Nikdy ho nevypíše.
03Může agent utrácet bez ptaní?
Před každou úlohou vám řekne cenu a váš zůstatek a nad pět hlav se zastaví a čeká na vaše potvrzení.
04Existuje server MCP?
Zatím ne. Skill funguje přes skript pro příkazovou řádku, který agenti spouštějí přímo.

Udělejte si MetaHuman z vlastní fotky.

Zaregistrujte se zdarma, stáhněte si ukázkové hlavy a dělejte hlavy z vlastních fotek, až se otevřou placené plány.