Generate, edit, and precisely control images directly from your AI coding agent using Bria.ai's commercially-safe models. Unlike black-box generators, Bria gives you fine-grained control: edit specific objects, mask regions, control lighting/season/style independently, and chain operations in pipelines.
Works with: Claude Code, Cursor, Cline, Codex, and 37+ other agents
npx skills add bria-ai/bria-skillSign up at platform.bria.ai and create an API key.
export BRIA_API_KEY="your-key-here"Or just start using the skill — it will walk you through setup automatically.
Ask your agent to generate images, remove backgrounds, edit photos, and more. The skill handles the rest.
| Skill | Description |
|---|---|
| bria-ai | Controllable image generation & editing — 18+ capabilities including text-to-image, object-level editing, background removal, upscaling, restyling, relighting, and product photography |
| vgl | Maximum generation control — structured JSON (Visual Generation Language) that explicitly defines objects, lighting, camera, composition, and style for deterministic, reproducible results |
| image-utils | Classic image manipulation — resize, crop, composite, watermarks, format conversion with Python Pillow |
| Capability | Control Level | Example |
|---|---|---|
| Generate images from text | Prompt + aspect ratio + VGL structured JSON | "A modern office with natural lighting, 16:9" |
| Edit specific objects | Object-level — add, replace, or remove by name | "Replace the red mug with a blue one" |
| Edit by instruction | Image-level — natural language control | "Change the mug color to red" |
| Edit masked regions | Pixel-level — paint exactly where to change | Inpaint only the sky, leave everything else |
| Remove backgrounds | Automatic — clean transparent PNGs | One API call, no manual masking |
| Control lighting | Independent — change light without touching content | Golden hour, spotlight, dramatic shadows |
| Control style | Independent — restyle without changing structure | Oil painting, anime, cartoon, 3D render |
| Control season | Independent — change season/weather only | Spring blossoms, winter snow |
| Expand images | Directional — extend boundaries with context | Outpaint to 16:9 from a square |
| Product photography | Scene control — place products in any setting | "Modern kitchen countertop, morning light" |
| Upscale resolution | 2x or 4x — preserves details | Super resolution enhancement |
| Pipeline chaining | Multi-step — compose operations in sequence | Generate -> remove BG -> lifestyle shot |
Building a website? Ask: "Generate a hero image for a SaaS landing page, 16:9, modern and clean"
E-commerce catalog? Ask: "Remove the background from this product photo and place it in a kitchen scene"
Batch assets? Ask: "Generate product photos for these 5 items and create transparent PNGs for each"
Presentations? Ask: "Create a slide visual showing data analytics, blue gradient, corporate style"
claude mcp add bria-skills -- npx -y bria-skillsDownload the skill folders to ~/.cursor/skills/. Each skill is a folder containing a SKILL.md file.
Copy the skills/ directory contents to your agent's skills directory.
- Bria API key — Free at platform.bria.ai
- For image-utils:
pip install Pillow requests
- bria-ai SKILL.md — Core skill with all capabilities
- API Endpoints Reference — Complete API documentation
- Workflows & Pipelines — Batch generation, parallel pipelines, integration examples
- VGL Schema Reference — Full VGL JSON schema
- Python Client — Full-featured async client
- TypeScript Client — Typed Node.js client
MIT