Gunni

AI media toolkit. Give any AI agent the ability to create professional media.

One CLI. Seven tools. Zero config.

Install

npm install -g gunni

Quick start

# Set up your API key
gunni config

# Generate an image
gunni image "coffee bag product shot, warm editorial light" -o bag.png

# Remove background
gunni image bag.png --remove-bg -o bag-clean.png

# Edit: place on a scene
gunni image bag-clean.png "on marble counter, morning light" -o hero.png

# Upscale
gunni image hero.png --upscale -o hero-final.png

# Describe (for alt text, iteration)
gunni image hero-final.png

# Generate video from image
gunni video hero.png -p "slow cinematic zoom in" -o hero.mp4

# Text to speech
gunni audio "Welcome to our roastery" -o intro.mp3

Use as an MCP server

Connect to the Gunni API server:

{
  "mcpServers": {
    "gunni": {
      "type": "streamable-http",
      "url": "https://api.gunni.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GUNNI_API_KEY"
      }
    }
  }
}

Commands

| Command | What it does | |---|---| | gunni image | Generate, edit, describe, upscale, remove background (smart routing) | | gunni video | Image or text to video | | gunni audio | Text to speech | | gunni learn | Creative expertise and best practices | | gunni list models | Discover available models | | gunni config | API key setup | | gunni init | Start a new project with BRIEF.md | | gunni history | Search past work |

How it works

One command handles all image operations. Gunni detects what you want from the inputs:

• Text only: generate
• Image + text: edit
• Image only: describe
• --upscale: upscale
• --remove-bg: remove background

Models

Curated set of the best model for each task. You don't pick models. Gunni routes to the right one.

| Capability | Model | |---|---| | Image generation | Nano Banana (Google) | | Image editing | Nano Banana Edit | | Design + typography | Recraft v4 | | Upscaling | Topaz | | Background removal | Bria | | Video | Kling v3 Pro | | Text to speech | MiniMax Speech HD |

Override with --model <id> when you have a reason.

Project system

Create a BRIEF.md in your project root to give Gunni creative direction:

# Kova Coffee

## Colors
- Primary: #2C1810 (espresso)
- Accent: #D4A574 (caramel)

## Style
- Warm editorial photography, natural light
- Minimalist, lots of negative space

Run gunni init --template brand to scaffold a project.

License

MIT