Viral Engine CLI

AI image and video generation
from your terminal

212 commands across every product area. Built for CI, automation, scripts, and autonomous agents. Generate with Nano Banana 2, GPT Image 2, Flux, Kling 3.0, Veo 3.1 and more from a shell, with the same brand Styles your team saved in the app.

~/projects
# install
$ npm install -g viral-engine-cli
+ [email protected]
# auth
$ ve login
Logged in as [email protected] (4,210 credits)
# generate
$ ve images generate "matte black water bottle, wet stone, side lighting" -m nano-banana-pro -n 4
Generated 4 images. Saved to gallery. 320 credits.
# animate the best one
$ ve videos generate -i ./bottle.png --provider kling-3.0 -f 9:16 -d 5
Job queued. Follow it with ve jobs watch <id>. 400 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

32 top-level commands, 212 commands

ve images generate

5 image models

ve videos generate

6 video engines, 10 options

ve images enhance

Magic Prompt, pipeable

ve gallery

Search and export

ve credits

Balance and billing

ve agents

Brand Styles and agents

ve conversations

Chat History, distill to a Style

ve agent

Talk to the Action Agent

ve videos voiceover

Voice Lab TTS (voice swap: ve videos voice-convert)

ve vsl

VSL Studio prompts and projects

ve workflows

List, create and edit workflows

ve jobs

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.
212 commands under 32 top-level commands, covering every product area: all 5 image models, all 6 video engines (10 options), voice, agents and Styles, chat History, gallery, credits, projects, VSL prompts, workflow definitions (runs happen in the app), funnels, leads, automation and 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 three commands

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