OSIG

Repo-ready OG images.

OSIG is the Open Source Social Image Generator. It gives AI agents a typed MCP and API workflow for deterministic Open Graph images.

Discover template contracts. Render previews. Export PNG or JPEG assets into a repository.

Generated OSIG preview for deterministic social preview images.
Generated OSIG preview describing the agent image contract.

Start with MCP

Copy the setup prompt.

Paste it into your coding agent and ask the agent to set up OSIG as an MCP server for deterministic Open Graph and social preview images.

A renderer shaped for agent work.

The agent gets typed choices, validates inputs, renders a preview, and exports bytes only when the image is ready.

Contract

Discover fields

Call get_image_contract to inspect templates, dimensions, formats, and accepted parameters.

Normalize

Send structured input

Pass title, subtitle, image URL, style, target network, format, and optional profile key.

Preview

Check the result

Review metadata, warnings, hash, content type, dimensions, and preview bytes before export.

Export

Commit or publish

Save a PNG or JPEG into the project, or use hosted output when production entitlement is in place.

What users get from OSIG.

Developers and publishers get repeatable social images without opening a design tool. Agents get a narrow, safe tool that can be called inside coding workflows.

Generated OSIG preview for exporting a production Open Graph image.

Lower routine image cost

Use code-rendered templates for routine OG images instead of asking an image model to rebuild a layout.

Predictable output

The same normalized spec renders the same output, with hashes and warnings returned to the caller.

Open source renderer, paid hosted path.

Self-hosting remains free and open. Hosted production use is designed around accounts, quotas, watermark removal, and paid entitlement.

Hosted MCP trial

Available for experimentation at /mcp/. The current public surface is intentionally narrow.

Production cloud

Expected to use profile-key authentication, visible quotas, and paid access before broad hosted use.

Self-hosted OSIG

Run the open source app locally or on your own infrastructure when you want full control.