Deploy and Host HyperFrames | HTML-to-Video Render API for AI Agents & n8n on Railway

HyperFrames is HeyGen's open-source framework for turning HTML into video: you describe a video as an HTML page animated with GSAP or CSS, and the renderer captures it frame by frame in headless Chrome and encodes it with FFmpeg. This template runs it as your own render API: send HTML, get back a link to the MP4. It works from curl, n8n, Make, your backend, and any AI agent through MCP.

About Hosting HyperFrames | HTML-to-Video Render API for AI Agents & n8n

The template deploys one service and a volume, with nothing to configure: the API key is generated for you. The image ships the same pinned chrome-headless-shell and FFmpeg builds HyperFrames uses in production, plus a full font set (Latin, CJK, emoji), so renders are deterministic: the same HTML always gives the same video.

Every request carries the API key. Renders go through a queue (one at a time by default), can be synchronous ("wait": true) or asynchronous with polling and signed webhooks, and finished videos are stored on the volume behind signed, expiring download links, or in any S3-compatible bucket such as a Railway Bucket. Old renders are cleaned up automatically. Open the service URL for a playground where you can paste HTML and watch the result.

Common Use Cases

Let Claude Code, Cursor or any MCP client write and render a video in one step: product teasers, launch announcements, explainers, social clips
Generate personalised videos at scale from n8n or Make: one design, a variable per row (name, logo, numbers), one MP4 each
Automate faceless and data-driven social content (Reels, TikTok, Shorts in 9:16) with captions, charts and music
Replace a paid cloud render service with your own, billed only for the CPU you use
Render transparent overlays (WebM, ProRes 4444) and GIFs for editors and websites

Dependencies for HyperFrames | HTML-to-Video Render API for AI Agents & n8n Hosting

Nothing external: Chrome, FFmpeg and fonts are inside the image
Optional: a Railway Bucket (or any S3-compatible storage) to serve videos from a bucket
Optional: an MCP client that supports Streamable HTTP with headers (Claude Code, Cursor, Windsurf, n8n)

Deployment Dependencies

HyperFrames: https://github.com/heygen-com/hyperframes (Apache-2.0)
Template source, API reference and n8n workflow: https://github.com/jean82290/hyperframes-railway

Implementation Details

Render with one request:

curl -X POST https://YOUR-SERVICE.up.railway.app/v1/renders \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "...", "format": "mp4", "wait": true}'

The response contains output.url, a signed link to the video. Sources: inline html, a files map, a .zip of a project folder, or a public URL. Options: format (mp4, webm, mov, gif), quality, fps, variables, outputResolution (landscape, portrait, square, 4K), webhookUrl.

Connect Claude Code:

claude mcp add --transport http hyperframes https://YOUR-SERVICE.up.railway.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

MCP tools: render_video, get_render, composition_guide (authoring rules, so any model writes valid compositions). The same guide is public at /llms.txt. Failed renders return a clear error (for example a script error in the composition) so agents can fix and retry.

Tuning variables: MAX_CONCURRENT_RENDERS (raise it on bigger plans, each render uses about 1 to 2 GB of RAM), MAX_RENDER_SECONDS, RETENTION_HOURS, DOWNLOAD_LINK_TTL_HOURS, and S3_* for bucket storage.

Unofficial deployment wrapper, not affiliated with HeyGen.

Why Deploy HyperFrames | HTML-to-Video Render API for AI Agents & n8n on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying HyperFrames | HTML-to-Video Render API for AI Agents & n8n on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.