GenFire CLI · v0.3.4

Generative media
from your terminal.

Generate images, videos, music, sound effects, and lipsync. Run multi-step workflow pipelines. Reference your trained influencers with @<handle>— the CLI auto-switches to the model's edit variant and threads identity through reference photos.

Install (one line)

npm install -g @genfire/cli

Or pick another path below. Already installed? Run genfire auth login to get started.

Install

Homebrew (macOS / Linux)

brew install genfireai/tap/genfire

npm (Node 20+)

npm install -g @genfire/cli

Install script (auto-installs Node)

curl -fsSL https://raw.githubusercontent.com/genfireai/cli/main/install.sh | sh

Source on GitHub. Pin a version with @0.3.4.

Quick start

genfire auth login                                       # browser PKCE auth
genfire                                                  # interactive shell
genfire generate image "@<your-handle> at sunset" -o sunset.png
genfire workflow run storyboard --inputs vars.json -o ./output

What you can do

genfire auth login

Browser-based PKCE auth — opens genfire.ai/cli-auth, click Approve

genfire mcp setup

Auto-configure the GenFire MCP server using your stored credentials — no key pasting

genfire

Interactive shell with splash, slash commands, and live job tracker

genfire generate image "@sarah at sunset" -o sarah.png

Generate with influencer @-mention (auto-switches to edit mode)

genfire generate video "..." -m video.veo_3_1 -d 8 -o out.mp4

Generate video — async polling with --wait by default

genfire workflow run storyboard --inputs vars.json -o ./output

Run a published workflow with typed inputs

genfire cost video "..." -m video.veo_3_1 -d 8

Preview cost before submitting an expensive run

genfire influencers list

Show your trained influencer characters

genfire models list -c image_generation

Browse the model catalog filtered by capability

Use with Claude Code

Beta

Skills teach Claude Code (and Cursor / OpenCode) how to invoke the GenFire CLI without paying the per-call MCP schema cost. Run both commands inside Claude Code, then ask in plain English.

Step 1 · Add the marketplace

/plugin marketplace add genfireai/skills

Step 2 · Install the skills (all five bundled)

/plugin install genfire@genfire

Includes genfire-generate, genfire-workflow, genfire-runs, and genfire-account.

Source & docs

npm

@genfire/cli

GitHub · CLI

genfireai/cli

GitHub · Skills

genfireai/skills

GitHub · TypeScript SDK

genfireai/sdk

Homebrew tap

genfireai/homebrew-tap

REST API docs

api.genfire.ai/v1/docs