OpenPromo

OpenPromo (openpromo.gg) turns your website into social posts, carousels, reels, promo videos and tutorials. Add your site and OpenPromo reads it into a brand profile: what you sell, who for, how you sound, your colours, fonts, logo and products. Every image and video is made from that profile, in your own fonts and colours, saying only what your site says.

Open source and self-hostable. Bring your own YepAPI key: OpenPromo charges nothing, every call is listed with its cost, and a monthly limit stops spending before it crosses the line you set.

⭐ If OpenPromo is useful to you, a star helps other people find it.

[!NOTE] OpenPromo is early and in active development. Issues and ideas are very welcome.

✨ Why OpenPromo

• 🧠 It knows your business first. One read of your website gives every tool the same brief: your selling points (each with the sentence and page it came from), audience, voice, colours, fonts, logo, products and getting-started steps. You edit it once; edits survive the next read.
• ✅ No made-up claims. Before anything renders, checks flag figures that are not on your site, hype words, text that is too long to read in time, a missing hook or a missing call to action.
• 🎞️ 43 templates to start from. UGC reviews with people talking to camera, 3D mascot skits, comic stories, claymation, cinematic product films, kinetic type, screen demos and more. Each one is filled in from your website, with an example for every template.
• 🏆 Models picked by testing. 18 image, 17 video and 16 voice models were tried on the same prompts. The defaults are the best for the price: GPT Image 2, Veo 3.1 Lite, Grok Imagine Video, ElevenLabs v4 and Lyria 3.
• 🔤 Real text, never garbled. Titles and captions are real text in your brand's fonts. Characters stay the same from scene to scene: each is drawn once as a reference sheet.
• 💬 Change it by chat. "Make it blue", "the owl wears a red scarf", "shorter voiceover": only what the change touches is made again.
• 🔓 Open source, all of it. The app, the API, the renderer and the agent server are MIT licensed.
• 💸 No surprise bills. Pay YepAPI per use with your own key. Generated pieces are kept, so re-rendering after an edit only pays for what is new.
• 🤖 Agents included. 20 MCP tools, a REST API and a Claude plugin with ready-made skills.

🧰 What you can make

Scenes come in ten layouts (hero, statement, big number, list, quote, screenshot in a device frame, product, picture and text, offer, call to action) and three looks (clean, bold, photo). One scene renders in any size; text shrinks until it fits, and colour pairs that would be hard to read are fixed.

🐳 Self-host with Docker

You need Docker. Rendering video runs Chrome and FFmpeg, so give it at least 2 CPUs and 4 GB of memory.

git clone https://github.com/duckduckdeploy/openpromo.git openpromo
cd openpromo
cp .env.example .env
# In .env, set AUTH_SECRET (32+ random characters)
# and ENCRYPTION_KEY (openssl rand -base64 32)
docker compose up -d --build

Service	Address
Dashboard	http://localhost:3200
Site and docs	http://localhost:3101
API and MCP	http://localhost:4100 (/api/*, /mcp)

One image runs everything: Postgres, the API with its MCP server, background worker and renderer (Chrome, FFmpeg and fonts included), the dashboard and the site. Database migrations run when the API starts; media files live in a Docker volume.

On a cloud server with your own domain, add HTTPS with automatic Let's Encrypt certificates:

1. Point your domain, app. and api. at the server.
2. Set OPENPROMO_DOMAIN, APP_URL, WEB_URL, PUBLIC_API_URL and POSTGRES_PASSWORD in .env.
3. Run docker compose --profile https up -d --build.

The self-hosting guide covers servers, updates, backups and every setting.

🤖 Connect your AI agent

The MCP server gives agents the whole workflow as 20 tools: read and edit the brand, browse templates, write ideas, write creations and edit them by chat, render, and fetch the files. Paid tools say what they cost.

ChatGPT and Claude (web and desktop): add a custom connector with the URL {API_URL}/mcp and OAuth sign-in. You sign in with your OpenPromo account and approve; no key needed.

For other agents, create an API key under Settings and store it in an environment variable named OPENPROMO_API_KEY. The quick way: copy the setup prompt from Settings and paste it into your agent; it connects itself and checks the connection with free calls only.

Claude Code: install the plugin, which bundles the connection and the skills:

/plugin install openpromo --marketplace duckduckdeploy/openpromo

Set OPENPROMO_MCP_URL to point it at a self-hosted install.

🧩 Skills

Skill	What it does
brand-check	Read your website and tidy up the brand profile every tool builds from
content-plan	A month of post ideas from your selling points, with captions
social-posts	On-brand images and carousels for Instagram, LinkedIn and ads
promo-reel	A short vertical video with voiceover and captions for Reels, TikTok and Shorts
tutorial-video	A getting-started walkthrough of your product, narrated

💳 What it costs

The software is free. Generation runs on your own YepAPI key, at YepAPI's prices:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗