Package Exports

melies
melies/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (melies) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Melies CLI - AI Agent Creative Toolkit

150 AI actors. 220+ visual styles. 50+ models. Zero prompt engineering.
Generate images, videos, movie posters, and YouTube thumbnails from the command line.

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

melies