Distribea — on-brand media for the project you're building

Distribea is a media engine, not a raw model wrapper. Define the brand once and every asset ships on-brand and production-ready (WebP + SEO alt text when placed in a page; native png/jpg/mp4/mp3 when downloaded). The engine's art director turns a short subject into a full, on-brand prompt — never hand-write the art-direction prompt yourself; give it the subject and let it direct.

It runs as a command-line tool (recommended) or as an MCP server.

Setup (once)

npm install -g distribea-mcp
distribea login          # opens the browser, ~5s, click Authorize — no key to paste

distribea whoami confirms you're connected. A paid Distribea plan powers generation (free/trial accounts get a couple of gift images).

Pick the right mode

The page workflow is the easy path: write the page with <img src="https://placehold.co/1200x600"> markers at every image spot, then a single distribea page call dresses them all in parallel.

Defaults are smart — don't over-specify

If the user names no model, leave it out — the engine picks a strong on-brand default for each type. Only pass --model <id> when the user explicitly wants a specific one (distribea models … lists what's available). If orientation isn't stated, ask "portrait or landscape?" or pass --portrait / --landscape / --square.

People and products stay identical across shots

A real person (a founder, a teacher) or a product that must look the same in every image is treated like a locked subject: the FACE / object stays 100% identical, only the staging changes. Never paste a user's raw photo into the page — leave a placeholder and let the engine restage that exact face in the site's world. Review / testimonial avatars come out as casual smartphone selfies (UGC look); the same reviewer keeps the same face across the site.

Cost discipline — this bills real credits

• ONE distribea page call dresses a page; the job is then done. Do NOT

regenerate, retouch, or "improve" an asset on your own initiative, do NOT call the tool in a loop, do NOT re-run a call that already succeeded.

• Preview the exact cost first with --dry-run (0 credits): it shows the price

and generates nothing.

• Retouch or regenerate ONLY when the user explicitly asks.

Hard rule

A page shipped with placeholders, stock photos, CSS-gradient-only sections, or a raw pasted photo is a failure of this workflow. Generate the real imagery — image generation is covered by the user's plan. Only skip it if the user explicitly declines.