{
  "version": "2",
  "generatedAt": "2026-11-03T21:36:30.074Z",
  "listing": {
    "slug": "heygen-com--hyperframes",
    "name": "HyperFrames",
    "tagline": "Write HTML, render deterministic MP4; a video framework whose primary interface is agent skills and a CLI.",
    "shortTagline": "HTML to deterministic MP4",
    "description": "HeyGen's open-source framework turns HTML, CSS, media, and seekable animations into video. Twenty skills teach a coding agent to plan, write, lint, preview, and render compositions; the CLI does the same by hand. Local rendering is free; HeyGen-hosted cloud rendering and AWS Lambda are the scale-out paths.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "video-streaming",
    "shape": "product",
    "formFactor": "cli",
    "executionModel": "deterministic",
    "provenance": "unknown",
    "codeStack": {
      "languages": [
        "TypeScript",
        "HTML",
        "CSS"
      ],
      "frameworks": [
        "GSAP",
        "Puppeteer",
        "ffmpeg"
      ],
      "packageManager": "bun",
      "database": [],
      "hostingTarget": [
        "local",
        "HeyGen cloud render",
        "AWS Lambda"
      ]
    },
    "modelStack": {
      "providers": [
        "optional Gemini for integrations",
        "any coding agent with skills support"
      ],
      "models": [],
      "requiredKeys": [
        "GEMINI_API_KEY (optional)"
      ],
      "promptLocations": [
        "skills/*/SKILL.md",
        "AGENTS.md",
        "CLAUDE.md"
      ],
      "tools": [
        "hyperframes init",
        "lint",
        "check",
        "snapshot",
        "preview",
        "render",
        "publish",
        "doctor",
        "cloud render",
        "lambda deploy/render/progress",
        "hyperframes add"
      ]
    },
    "repos": [
      {
        "url": "https://github.com/heygen-com/hyperframes",
        "owner": "heygen-com",
        "name": "hyperframes",
        "license": "Apache-2.0",
        "stars": 43734,
        "lastCommit": "2026-09-03"
      }
    ],
    "interface": {
      "kind": "cli",
      "url": "https://github.com/heygen-com/hyperframes#skills",
      "official": true,
      "hosted": "both"
    },
    "operability": "native",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Plan and write a composition from a brief",
        "reachable": true,
        "evidence": "README: /hyperframes router plus creation workflows (/product-launch-video, /faceless-explainer, /general-video)"
      },
      {
        "job": "Lint and check a composition",
        "reachable": true,
        "evidence": "README /hyperframes-cli: lint, check"
      },
      {
        "job": "Preview in the browser",
        "reachable": true,
        "evidence": "README: npx hyperframes preview"
      },
      {
        "job": "Render MP4 locally",
        "reachable": true,
        "evidence": "README: npx hyperframes render"
      },
      {
        "job": "Render in HeyGen cloud or AWS Lambda",
        "reachable": true,
        "evidence": "README /hyperframes-cli: cloud render, lambda deploy / render / progress"
      },
      {
        "job": "Add captions to talking-head footage",
        "reachable": true,
        "evidence": "README: /embedded-captions workflow"
      },
      {
        "job": "Source or generate music, SFX, images, voice",
        "reachable": true,
        "evidence": "README: /media-use resolves or generates media, TTS, transcription"
      },
      {
        "job": "Mix audio already in the composition",
        "reachable": true,
        "evidence": "README: /hyperframes-audio effect chain and automation"
      },
      {
        "job": "Install registry blocks and components",
        "reachable": true,
        "evidence": "README: hyperframes add, /hyperframes-registry"
      },
      {
        "job": "Port a Remotion composition",
        "reachable": true,
        "evidence": "README: /remotion-to-hyperframes one-way migration"
      }
    ],
    "editions": [
      {
        "name": "Free",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/heygen-com/hyperframes"
          },
          {
            "kind": "installable",
            "url": "https://github.com/heygen-com/hyperframes#quick-start",
            "command": "npx skills add heygen-com/hyperframes"
          }
        ]
      },
      {
        "name": "Cloud render",
        "price": null,
        "open": false,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://hyperframes.heygen.com/"
          }
        ]
      }
    ],
    "skills": {
      "kind": "bundled",
      "paths": [
        ".agents/skills/*/SKILL.md"
      ],
      "install": "npx skills add heygen-com/hyperframes",
      "note": "Ships about twenty video-production skills that are the intended way to drive the CLI; a router skill installs the rest on demand."
    },
    "customization": {
      "summary": "A project is a folder with hyperframes.json and an index.html composition; adapting a template means editing the HTML, the data-* timing attributes, and hyperframes.json (schema in docs/schema/hyperframes.json). No env var is required for local use; GEMINI_API_KEY is optional. The skills themselves are Markdown you can edit or extend.",
      "envVars": [
        "GEMINI_API_KEY"
      ],
      "configFiles": [
        "hyperframes.json",
        "index.html",
        ".env"
      ],
      "promptFiles": [
        "skills/hyperframes/SKILL.md",
        "skills/hyperframes-core/SKILL.md",
        "skills/media-use/SKILL.md",
        "AGENTS.md"
      ],
      "effort": "light-edit",
      "editCount": 8
    },
    "useWhen": [
      "I want my agent to make product promos and explainers as HTML I can read and diff, not a proprietary project file",
      "I need deterministic batch renders from templates and want to run them on Lambda or HeyGen's cloud"
    ],
    "accounts": [
      "HeyGen account (cloud render only)",
      "AWS (Lambda render only)"
    ],
    "active": true,
    "lastActivity": "2026-09-03",
    "gotchas": [
      "A non-interactive `skills add` without --skill installs all 20 skills; agents should use `npx hyperframes skills update` for the core set",
      "The skills.sh registry can lag main by hours",
      "Renders need Chromium through Puppeteer; check `hyperframes doctor` first"
    ],
    "fit": {
      "adaptable": 3,
      "operable": 3
    },
    "evidence": {
      "formFactor": "README: npx hyperframes CLI plus agent skills; Studio is secondary",
      "executionModel": "README: deterministic MP4 from HTML; models only in optional media generation",
      "operability": "README tagline 'Built for agents'; skills and CLI shipped by heygen-com",
      "effort": ".env.example says no env vars required; hyperframes.json schema in docs/schema; compositions are HTML",
      "editions": "Apache-2.0 LICENSE; README lists HeyGen-hosted cloud rendering; price not in README",
      "active": "GitHub pushedAt 2026-09-03"
    },
    "confidence": {
      "formFactor": 0.9,
      "executionModel": 0.75,
      "operability": 0.95,
      "effort": 0.85,
      "reach": 0.9,
      "editions": 0.7
    },
    "openQuestions": [
      "Cloud render pricing and the auth flow (packages/cli/src/commands/auth.ts, docs/guides/authentication.mdx) were not fetched; record price and env var names",
      "Provenance: HeyGen has not stated how the framework was written"
    ],
    "sources": [
      {
        "url": "https://github.com/heygen-com/hyperframes",
        "foundBy": "sourcing:video-streaming:github"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Native skills plus CLI, Apache-2.0, documented hyperframes.json and composition surface; both capabilities at 3.",
      "disputed": []
    },
    "url": "apps/heygen-com--hyperframes.html",
    "coverage": "complete",
    "paid": false,
    "source": "research/verified/heygen-com--hyperframes.json"
  }
}