hyperframes
Create deterministic authored-motion MP4/WebM/MOV videos from HTML/CSS/JS compositions through Ambient's bundled HyperFrames adapter.
- License 许可
- MIT
- 最近更新
- 2026-07-25
- Stars
- ★ 7
- Forks
- 4
01 前言 Front Matter
- name
- hyperframes
- description
- Create deterministic authored-motion MP4/WebM/MOV videos from HTML/CSS/JS compositions through Ambient's bundled HyperFrames adapter.
02 资源文件 3
- 参考文档ambient-cli.json1.8 KB
- 脚本scripts/run.mjs31.9 KB
- 脚本tests/smoke.test.mjs2.7 KB
03 SKILL.md 正文
HyperFrames Ambient Adapter
Use this capability when the user wants authored motion graphics, title cards, animated charts, UI demos, social overlays, or HTML/CSS/JS video scenes. Do not present HyperFrames as a text-to-video or photorealistic video model.
Discovery And Setup
- Find this package with
ambient_cli_searchusing terms likeHyperFrames,authored video,motion graphics,title card,HTML to video, ordeterministic MP4. - Call
ambient_cli_describebefore first use so the current command names, readiness, setup hints, and artifact contract are visible. - Run
hyperframes_doctor --jsonbefore rendering unless the package description already includes fresh readiness data. - Heavy setup is lazy and approval-gated. Do not silently install FFmpeg, FFprobe, Chrome/browser runtime, Node, npm packages, or the HyperFrames CLI.
- If dependencies are missing, run
hyperframes_setup_plan --jsonand present the exact blocked state plus approval-gated next action.
Commands
hyperframes_doctor --json: reports Node, npx, FFmpeg, FFprobe, optional HyperFrames CLI, and optional browser readiness. The built-in health check is fast and non-mutating.hyperframes_setup_plan --json: returns non-executing setup actions such asbrew install ffmpeg, HyperFrames CLI install, and browser runtime install guidance.hyperframes_init --project-dir <dir> --title <text> --subtitle <text>: writes a small deterministic composition project in the workspace.hyperframes_inspect --source <path> --json: reads the composition and returns dimensions, duration, fps, source bytes, and structural checks.hyperframes_render --source <path> --output <path> --json: runs lint/inspect/render when the host is ready, then verifies media with FFprobe and writes metadata.
Artifact Contract
Every real render should preserve:
- Source HTML path and project directory.
- Rendered media path.
- Metadata JSON path.
- Full lint, inspect, render, FFprobe, and FFmpeg stdout/stderr logs where produced.
- First-frame preview path when FFmpeg can extract it.
- Bounded stdout preview for the chat transcript.
Keep final media in the user's workspace, preferably under .ambient/hyperframes/renders/ unless the user chose a path.
Safety And Boundaries
- Treat composition HTML/CSS/JS as executable workspace project code.
- Avoid remote assets unless the user approves the provenance and network use.
- Prefer local files and deterministic HTML attributes. Use HyperFrames'
hf-seekevent or data attributes rather than wall-clock timers. - For quick title cards, the scaffolded composition is enough. For richer scenes, write/edit the source first, inspect it, then render.
- If the render fails, attach or cite the saved logs and run
hyperframes_doctor --jsonagain before suggesting dependency changes.
04 同仓库更多 Skills
ambient-tinystyler
Create reusable TinyStyler style profiles from user text examples and apply TinyStyler-style text transfer through Ambient CLI.
ambient-qwen3-asr
Local Qwen3-ASR speech-to-text provider for Ambient push-to-talk.
ambient-minicpm-v-vision
Local MiniCPM-V visual-understanding provider for Ambient screenshot, UI, game-frame, and image evidence.
ambient-imagegen
Generate raster images through hosted APIs such as OpenAI, Google Nano Banana Pro, fal/FLUX, Replicate, Stability AI, and Ideogram.
ambient-faster-whisper-stt
Local faster-whisper STT provider for Ambient speech input validation.
ambient-blockchain
Safely observe the Ambient Blockchain, plan Tool Oracle and x402 interactions, prepare Ambient program deployment work, and run local live-test evidence gates.