AI image generation from the terminal

Four Interfaces, One API

Pick the one that fits your workflow. They all use the same API key and credit balance.

pixelmuse "a cyberpunk city at night" -m recraft-v4 -a 16:9

pixelmuse ui

{ "pixelmuse": { "command": "npx", "args": ["-y", "pixelmuse-mcp"] } }

"generate a blog thumbnail for my React hooks post"

CLI Reference

All commands and flags at a glance.

Commands

Flags

MCP Server Setup

Give your AI agent the power to generate images. Add this to your editor config.

{
  "mcpServers": {
    "pixelmuse": {
      "command": "npx",
      "args": ["-y", "pixelmuse-mcp"],
      "env": {
        "PIXELMUSE_API_KEY": "pm_live_your_key_here"
      }
    }
  }
}

Prompt Templates

Save reusable prompts as YAML files with variables and default settings.

# Scaffold a new template
pixelmuse template init product-shot

# Generate with a template
pixelmuse template use blog-thumbnail --var subject="React hooks guide"

# List all templates
pixelmuse template list

name: Blog Thumbnail
description: Dark-themed blog post thumbnail
prompt: >
  A cinematic {{subject}} on a dark gradient background,
  dramatic lighting, 8K resolution
defaults:
  model: nano-banana-2
  aspect_ratio: "16:9"
variables:
  subject: "code editor with syntax highlighting"
tags: [blog, thumbnail, dark]

Models

Switch models with -m model-id. All models available on every plan.