Open source · Agent Skill · CLI · MCP

Pinterest in.Posts out.

pinmuse is an AI design agent. It studies real pins, learns the look, generates the image with your model and sets the type itself. You get a finished post, story or carousel.

curl -fsSL https://raw.githubusercontent.com/prantikmedhi/pinmuse/main/install.sh | bash
See how it works Star on GitHub
How it works

One sentence.
Six moves.

“A carousel for our chrome drop.” Scroll to watch pinmuse make it.

  1. ExploreSearches Pinterest by phrase, pin or board, signed out and throttled.
  2. DistillBuilds a moodboard and reads its palette, light, warmth and motifs.
  3. PromptWrites the image prompt, with empty space where the type will sit.
  4. GenerateRenders with your model: gpt-image, Gemini, Flux, ComfyUI or none.
  5. ComposeSets real fonts with auto-fit, safe zones and grain.
  6. ShipHands back the file, a caption, hashtags and pin credits.
Carousels

A new photo on every slide.

Cover, numbered slides and a save-this end card. Give each slide a subject and pinmuse generates a picture for it. Swipe or drag them.

  • The chrome drop, cover
  • The chrome drop, slide 1
  • The chrome drop, slide 2
  • The chrome drop, slide 3
  • The chrome drop, end card
1/5

The chrome drop

product · y2k

  • Made of glass, cover
  • Made of glass, slide 1
  • Made of glass, slide 2
  • Made of glass, slide 3
  • Made of glass, end card
1/5

Made of glass

objects · minimal luxe

  • Soft tech, cover
  • Soft tech, slide 1
  • Soft tech, slide 2
  • Soft tech, slide 3
  • Soft tech, end card
1/5

Soft tech

product · pastel dream

  • Squeeze the day, cover
  • Squeeze the day, slide 1
  • Squeeze the day, slide 2
  • Squeeze the day, slide 3
  • Squeeze the day, end card
1/5

Squeeze the day

drinks · brutalist

  • Everything is inflatable, cover
  • Everything is inflatable, slide 1
  • Everything is inflatable, slide 2
  • Everything is inflatable, slide 3
  • Everything is inflatable, end card
1/5

Everything is inflatable

fashion · clean

  • Space age kitchen, cover
  • Space age kitchen, slide 1
  • Space age kitchen, slide 2
  • Space age kitchen, slide 3
  • Space age kitchen, end card
1/5

Space age kitchen

retro futures · vaporwave

  • The noir edit, cover
  • The noir edit, slide 1
  • The noir edit, slide 2
  • The noir edit, slide 3
  • The noir edit, end card
1/5

The noir edit

luxury · gothic

  • Made of clay, cover
  • Made of clay, slide 1
  • Made of clay, slide 2
  • Made of clay, slide 3
  • Made of clay, end card
1/5

Made of clay

gadgets · cottagecore

  • Places that look unreal, cover
  • Places that look unreal, slide 1
  • Places that look unreal, slide 2
  • Places that look unreal, slide 3
  • Places that look unreal, slide 4
  • Places that look unreal, end card
1/6

Places that look unreal

travel · moody film

  • Shoot the city at night, cover
  • Shoot the city at night, slide 1
  • Shoot the city at night, slide 2
  • Shoot the city at night, slide 3
  • Shoot the city at night, slide 4
  • Shoot the city at night, end card
1/6

Shoot the city at night

how-to · cyberpunk neon

  • Better coffee at home, cover
  • Better coffee at home, slide 1
  • Better coffee at home, slide 2
  • Better coffee at home, slide 3
  • Better coffee at home, end card
1/5

Better coffee at home

guide · earthy boho

  • Concrete, but make it beautiful, cover
  • Concrete, but make it beautiful, slide 1
  • Concrete, but make it beautiful, slide 2
  • Concrete, but make it beautiful, slide 3
  • Concrete, but make it beautiful, end card
1/5

Concrete, but make it beautiful

architecture · brutalist

  • Make your room feel like a dream, cover
  • Make your room feel like a dream, slide 1
  • Make your room feel like a dream, slide 2
  • Make your room feel like a dream, slide 3
  • Make your room feel like a dream, end card
1/5

Make your room feel like a dream

tips · pastel dream

Raw generations · 80 photos

The pictures underneath.

The base images before layout. pinmuse prompts for the subject, the learned palette and light, and room for the headline.

Install

Lives inside your agent.

The installer adds the CLI and links the skill into every agent it finds. Add --mcp to register the MCP server.

  • Claude Codeplugin · mcp
  • Codexskill · mcp
  • Gemini CLIextension
  • Antigravityskill
  • opencodeskill · mcp
  • OpenClaw · Hermesskill
  • Cursor · VS Codemcp
  • Any MCP client8 tools
# in Claude Code, Codex or Gemini CLI
Make an Instagram story for our Friday
rooftop party. Get the vibe from
Pinterest: vaporwave sunset.

# pinmuse searches, builds a moodboard,
# generates, composes, and returns:
story-ig-story.jpg  caption.txt  manifest.json
Image models

Bring any model.
Or none.

OpenAI gpt-imageOPENAI_API_KEY
Azure OpenAIOPENAI_BASE_URL
GeminiGEMINI_API_KEY
Fluxfal · replicate · together
StabilitySTABILITY_API_KEY
ComfyUI · A1111local
diffuserscuda · mps · cpu
Any CLIPINMUSE_IMAGE_CMD
FAQ

Questions.

Is reading Pinterest allowed?

pinmuse reads public pages signed out, cached and throttled to human volume, and never asks for your password. Use the official API for private boards, and check Pinterest's terms for commercial use.

Will it copy someone's pin?

No. Pins set the direction: palette, light and composition. The skill forbids reproducing pins, people, logos or watermarks, and every manifest credits the pins it learned from.

Do I need an API key?

No. Without one you get typographic designs on procedural backgrounds. A gpt-image, Gemini or Flux key gives photographic results like the gallery.

Which platforms and sizes?

Instagram posts, stories and reel covers, Pinterest pins, X, LinkedIn, YouTube thumbnails, Facebook covers, print posters, wallpapers, or any custom size.