Vincent

Turn a single product image into a polished marketing video — entirely in your terminal.

Vincent is an AI agent that takes your product photo and a short brief, then handles everything: concept writing, scene image generation, animation, and final video assembly. No video editing skills required.

Built on Google Gemini (LLM + image generation) and Veo3 (video generation).

Requirements

Node.js ≥ 22 (LTS), Node 24 recommended. Install via nvm: nvm install 24 && nvm use 24.

Install

npm install -g @magyk/vincent
vincent --version

Get a Gemini API key

Google AI Studio is the fastest way to get a key — one key covers the LLM, image generation, and Veo video generation.

1. Go to aistudio.google.com and sign in with your Google Account.
2. Click Get API key (or API keys) in the sidebar.
3. Click Create API key. You can create it in a new or existing Google Cloud project.
4. Copy the key and keep it somewhere safe — you'll paste it into Vincent on first run.

Billing note: AI Studio uses a tiered billing system. New accounts start on a free tier with generous rate limits. For high-volume or production use you'll need to link a billing account.

Usage

vincent                          # start a new session
vincent product.jpg              # start with an image already loaded
vincent --image product.jpg      # same, explicit flag (useful in scripts)

First run: Vincent will prompt you to paste your Gemini API key — it's saved automatically and you won't be asked again. The TUI will show you how to provide an image and what commands are available.

API keys are stored in ~/.local/share/magyk/settings.json (Linux) or ~/Library/Application Support/magyk/settings.json (macOS). You can also use /settings inside the TUI to manage them, or set GEMINI_API_KEY in your environment (takes priority over the saved key).

Options

vincent [image] [options]

  --image <url|path>     Product image URL or local path (equivalent to positional arg)
  --video-model <id>     veo3 or veo3-lite (default: veo3-lite)
  --storage <path>       Override artifact output directory
  --self-test            Run built-in diagnostics and exit
  --version, -v          Print version and exit
  -h, --help             Show help

License

See LICENSE for terms. © 2026 Magyk Inc.