melies

v2.3.0

Published

2 months ago

AI Agent Creative Toolkit. 150+ AI actors, 220+ visual styles, 50+ models. Generate images, videos, posters, and thumbnails from the command line.

0High
0Medium
0Low

romainsimon

melies ai-video ai-image movie-poster ai-filmmaking video-generation image-generation cli ai-agent command-line youtube-thumbnail ai-actors

Quick Start

npm install -g melies

Then authenticate:

# Browser login (opens melies.co, authenticates automatically)
melies login

# Or use an API token directly (for CI/agents)
melies login --token YOUR_TOKEN

# Or set as environment variable
export MELIES_TOKEN=your_token

Generate an API token at melies.co > Settings > API.

Start generating:

melies image "portrait in a café" --actor mei --art-style ghibli --lighting golden --sync

What It Does

150+ AI actors with identity consistency across every generation
220+ visual styles covering art styles, lighting, camera angles, expressions, moods, color grades, eras, and more
50+ AI models from Flux, Kling, Veo, Runway, Luma, Hailuo, Seedance, Wan, and others
Image → Video pipeline in a single command (generates image, then animates it)
Movie posters with title, credits, cast, and 20 style presets
YouTube thumbnails with batch generation (up to 4 variations)
Upscale and background removal powered by AI
Built for AI agents with structured JSON output, SKILL.md auto-discovery, and predictable flags
Smart model selection with --fast, --quality, and --best presets (no need to memorize model names)

Examples

Generate an image with an AI actor

melies image "cinematic portrait in golden hour" --actor mei --art-style ghibli --lighting golden --sync

Generate a movie poster

melies poster "Midnight Protocol" --actor dante --actor elena --style anime --sync

Image → Video pipeline in one command

melies pipeline "tracking shot through neon Tokyo" --actor hailey --best --sync

Generate 4 YouTube thumbnails

melies thumbnail "shocked face reacting to AI news" --actor aria -n 4 --sync

Preview cost before generating

melies image "sunset" --quality --actor hailey --dry-run

Visual Style Flags

Combine freely on any image, video, thumbnail, or pipeline command. Browse all styles.

| Flag | Examples | |------|---------| | --art-style | ghibli, anime, noir, oil, watercolor, concept | | --lighting | golden, neon, noir, rembrandt, backlit, soft | | --camera | eye-level, high, low, overhead, dutch | | --shot | close-up, medium, cowboy, wide, full-body | | --expression | smile, surprised, serious, villain-smirk | | --mood | romantic, mysterious, tense, ethereal, epic | | --color-grade | teal-orange, mono, warm, cool, filmic | | --era | victorian, 1920s, 1980s, modern, dystopian |

Plus: --time, --weather, --composition, --dof, --focal-length, --aperture, --lens, --exposure, --camera-model, --movement

melies image "woman in a café" --lighting golden --mood romantic --art-style ghibli --era 1920s --sync

Smart Model Selection

Use quality presets instead of model names:

| Preset | Image Model | Image Cost | Video Model | Video Cost | |--------|------------|------------|------------|------------| | --fast (default) | flux-schnell | 2 cr | kling-v2 | 30 cr | | --quality | flux-pro | 8 cr | kling-v3-pro | 100 cr | | --best | seedream-3 | 6 cr | veo-3.1 | 400 cr |

Override with -m <model>. Run melies models or browse all models.

AI Actors

148 built-in characters with identity consistency across every generation. Browse all actors.

melies actors                              # List all actors
melies actors --gender female --age 20s    # Filter
melies actors search "asian"               # Search

# Create a custom actor from any face
melies ref create "jean-pierre" -i photo.jpg

All Commands

| Command | Description | |---------|-------------| | melies image | Generate images from text prompts | | melies video | Generate videos from text or image prompts | | melies pipeline | Image → Video in one command | | melies poster | Movie posters with title, credits, and cast | | melies thumbnail | YouTube thumbnails with batch generation | | melies upscale | AI image upscaling | | melies remove-bg | Background removal | | melies actors | Browse 150+ AI actors | | melies styles | Browse 220+ visual styles | | melies credits | Check your credit balance | | melies models | List all available models | | melies status | Check generation status | | melies assets | List your generated assets | | melies login | Authenticate (browser or token) |

For AI Agents

Melies is built for AI agents. Generation commands always output JSON. Browse commands (credits, models, actors, assets, styles) show tables by default. Use --json to get structured JSON output for parsing. The CLI ships with a SKILL.md file that any agent can read for auto-discovery.

Works with: Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, Codex, Gemini, Goose, Amp, Trae, Vibe, Replit, OpenCode, Manus, and any agent that reads SKILL.md.

# Token auth for CI/agents
melies login --token YOUR_TOKEN

# Or set as environment variable
export MELIES_TOKEN=your_token

See the Agent Documentation for integration patterns and best practices.

Powered by 50+ AI Models

Flux, Kling, Veo, Runway, Luma, Hailuo, Seedance, Wan, LTX, ElevenLabs, xAI Grok, ByteDance, Meta, and more. New models added regularly.

License

MIT