Viral Engine CLI

AI image and video generation
from your terminal

124 commands. Full platform parity. Built for CI, automation, scripts, and autonomous agents. Generate Nano Banana 2, Imagen 4, Flux, Kling, Luma, and Veo 3 from a shell.

~/projects
# install
$ npm install -g viral-engine-cli
+ [email protected]
# auth
$ ve login
Logged in as [email protected] (4,210 credits)
# generate
$ ve generate "matte black water bottle, wet stone, side lighting" --model imagen-4-ultra --count 4
Generated 4 images. Saved to gallery. -100 credits.
# animate the best one
$ ve video --image last --model kling --aspect 9:16
Job queued. ETA 90s. -200 credits.

Why a CLI

When the dashboard is the wrong tool

CI and CD

Generate fresh hero images on every PDP update. Refresh your social feed nightly. Replace stale ad creative on a cron.

Bulk and batch

Pipe a CSV of products into a script that generates 4 variations each. The dashboard is fine for one. The CLI is for one thousand.

Agent loops

Pair with Claude or GPT-4 tool-use to build self-running creative pipelines. The CLI is intentionally agent-friendly: clean JSON, predictable shapes.

Surface

25 modules, 124 commands

ve generate

Image generation

ve video

Video generation

ve enhance

Prompt enhancer

ve gallery

Search history

ve credits

Account balance

ve agents

Saved templates

ve projects

Project workspaces

ve voice

Voice Lab TTS

ve vsl

VSL pipeline

ve workflow

Workflow runner

ve models

Model catalog

ve job

Async jobs

Run ve --help for the complete catalog.

Questions

CLI FAQ

npm install -g viral-engine-cli. The binary is available as both ve and viral-engine. Configure with ve login. Config is stored at ~/.viral-engine/config.json.
124 commands across 25 modules with full platform parity: all six image models, all five video models, agents, gallery, credits, projects, voice, VSL, workflows, jobs.
Yes. Set VIRAL_ENGINE_TOKEN in CI secrets. JSON output mode (--json) returns parseable structure. Exit codes are CI-friendly.
Yes. Pair with Claude or GPT-4 tool-use to build self-running pipelines. Predictable command shapes and clean JSON make it agent-friendly. See also the in-app Action Agent.
Yes. The CLI is free. You only pay credits for the underlying generation at the same rates as the dashboard.

New in v1.1

Use it from Claude Desktop

The CLI now ships an MCP server. One config line and Claude Desktop can generate images, generate videos, search your gallery, and check credits, all scoped to your account.

1. Install + log in

$ npm i -g viral-engine-cli
$ ve login

2. Add to Claude Desktop config

// ~/Library/Application Support/Claude/
// claude_desktop_config.json
{
  "mcpServers": {
    "viral-engine": {
      "command": "npx",
      "args": ["viral-engine-mcp"]
    }
  }
}

Restart Claude Desktop. Tools available: generate_image, generate_video, gallery_search, enhance_prompt, check_credits, analyze_image, animate_image + more.

Generate from your shell in 60 seconds

$ npm i -g viral-engine-cli
$ ve login
$ ve generate "your idea here"
Get a token, free