convez.ai
MCP ServerAutomaçãoIntermediário
Framehood

Framehood CLI

Framehood/framehood-cli

Gere conteúdo visual e áudio do terminal com MCP nativo

Ver no GitHub
InicialPluginScore · de 0 a 100

Cliente MCP nativo para gerar imagens, vídeos e áudio diretamente do terminal. Suporta modo one-shot para pipelines e Studio interativo para exploração criativa. Integração first-class com o protocolo Model Context Protocol.

Instalação

$npx convez-ai Framehood/framehood-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 4 meses
Versão
v0.3.8
Issues abertas
0
Contribuidores
2

Casos de uso

  • Automatizar geração de imagens, vídeos e áudio em scripts e pipelines
  • Explorar criação de conteúdo via interface interativa no terminal
  • Integrar geração de mídia em fluxos DevOps e CI/CD

Veredito

Ferramenta sólida e bem-integrada ao MCP para automatizar geração de conteúdo multimídia em linha de comando. Ideal para pipelines e scripts que precisam produzir imagens, vídeos e áudio programaticamente sem deixar o terminal.

README

A tradução para o português deste README ainda está na fila.

Framehood CLI

Generate images, video, and audio from your terminal. The CLI is a first-class MCP client — it speaks the same interface as every other Framehood integration.

Two modes:

  • One-shot — framehood generate "…" runs a single job and prints the result URL. Great for scripts and pipelines.
  • Studio — framehood with no arguments opens an interactive terminal UI.

Install

Homebrew (macOS / Linux)

brew install framehood/tap/framehood

npm

npm install -g framehood

go install

go install github.com/Framehood/framehood-cli@latest

This installs the binary as framehood-cli (Go names it after the module). For the framehood command, prefer Homebrew or npm above, or mv it after install.

Prebuilt binaries

Download for your platform from the latest release, extract, and put framehood on your PATH.

Build from source

git clone https://github.com/Framehood/framehood-cli
cd framehood-cli
go build -o framehood .

Sign in

framehood login

Opens your browser (OAuth 2.1 + PKCE, loopback redirect). The token is stored at ~/.framehood/credentials.json (0600) and refreshed automatically. Sign out with framehood logout. You'll need a Framehood account.

One-shot generation

framehood generate "a red fox in the snow"
framehood generate --type audio --voice Rachel "welcome to Framehood"
framehood generate --type video "a drone shot over a coastline"
FlagDefaultNotes
--type, -timageimage · video · audio
--out, -oby typeoutput filename
--actionby typeoverride the tool action (create, speak, scene, animate, …)
--tier—image quality: draft · fine · photo
--format—aspect/size: friendly names square · portrait/9:16 · landscape/16:9 · 3:4 · 4:3 · shorts · reels (case-insensitive), or a raw preset like landscape_16_9. Works on the actor path too.
--actor—route through an actor (act_…)
--voice—voice name for audio speak
--shot / --multi-prompt—image animate: one timeline shot "prompt@duration" (repeatable; see below)
--shot-type—image animate: how multi-prompt shots are stitched — customize (default) · intelligent

generate submits the job and polls until it finishes, then prints the output URL.

Multi-shot animation (image --action animate)

Animate an image into a continuous clip built from several timed shots (Kling). Pass each shot as --shot "prompt@duration" (or the longer --multi-prompt); repeat the flag for more shots. The @duration suffix is optional — it defaults to 5s and may carry a trailing s (@4 and @4s are equivalent):

framehood generate --type image --action animate --image-url frame.jpg \
  --shot "wide establishing shot@3s" \
  --shot "push in on the face@4s" \
  --shot-type customize

Limits (validated locally before the call): at most 6 shots, a combined runtime ≤ 15s, each shot 1–15s. --shot/--multi-prompt is mutually exclusive with the positional prompt — use one or the other. With --actor and no --image-url, the actor supplies the source frame.

Other one-shot commands

The CLI mirrors the full MCP/REST surface — every command renders human-readable output (no raw JSON dumps):

CommandWhat it does
framehood whoami · framehood balanceyour account / credit balance
framehood billing <balance|plan|plans|transactions>credits, plan, and the credit ledger
framehood billing <preview|change> <package> · billing cancel [--reactivate]owner-only subscription changes
framehood billing extra-usage [flags]owner-only: view or configure premium overflow top-ups (see below)
framehood billing topup --eur Nbuy €N of extra credits now via a hosted Stripe invoice (see below)
framehood jobs [list] · framehood jobs cancel <id>generation history; cancel a running job
framehood files <list|upload|delete|publish|unpublish|download>manage your storage (download -o <path> writes to disk)
framehood project <list|create|update|delete|assign|use|current>group generations into projects
framehood team … · framehood team accept-invite <token>your organization: members, spend, roles, invites
framehood keys <list|create|delete>programmatic API keys (the secret is shown once on create)
framehood models [kind] · framehood skill <kind> · framehood workflows [name]the model catalog, a model's prompt guide, and multi-step workflows
framehood library …search past generations and manage the trash

Run framehood <command> --help for the flags on each.

Extra usage (billing extra-usage)

Extra usage automatically tops up credits at a premium overflow rate when your balance runs low, charging the card on your subscription. It is owner-only.

framehood billing extra-usage                                  # view the current config
framehood billing extra-usage --enable --amount-eur 5 --trigger 200
framehood billing extra-usage --cap-eur 50
framehood billing extra-usage --disable

With no flags it prints the current config (enabled, amount per top-up and its ≈credit value, trigger balance, per-cycle cap and spend, card-on-file, and the premium-rate note). With any flag it updates only the fields you set:

FlagNotes
--enable / --disableturn Extra usage on or off
--amount-eur <n>euros charged per top-up — at least €5, in €5 steps (validated locally)
--trigger <credits>top up when the balance drops below this many credits
--cap-eur <n>max euros of Extra usage allowed per billing cycle

One-off top-up (billing topup)

Buy a batch of extra credits now, without changing your plan. It raises a hosted Stripe invoice at the extra-usage rate and prints a URL to open and pay.

framehood billing topup --eur 20    # the minimum
framehood billing topup --eur 100

--eur is required and must be a whole-euro amount between €20 and €5,000 (validated locally). An owner with a card on file is charged automatically — the hosted page is then the receipt; otherwise you pay on the hosted page. Credits land once the invoice is paid.

Studio (interactive)

framehood
  • ⇥ / ← → — switch between image / video / audio
  • type a prompt, enter — generate (live status while it runs)
  • o — open the result in your browser
  • esc — quit

Configuration

Env varDefaultPurpose
FRAMEHOOD_MCP_BASEhttps://mcp.framehood.aiMCP + OAuth origin
FRAMEHOOD_API_BASE(the MCP base)REST origin for the /v1/… read endpoints (models, workflows)
FRAMEHOOD_CONFIG_DIR~/.framehoodcredentials/state directory

Docs

Full documentation: https://docs.framehood.ai

License

Framehood is a proprietary, source-available product. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados