@hypit/hypit 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+# Open Source License
+
+Hypit is licensed under a modified version of the Apache License 2.0, with the following additional conditions:
+
+1. Hypit may be utilized commercially for your own organization's purposes, including as a rendering or generation backend for applications your organization operates for itself, and as internal tooling within an enterprise. Should any of the conditions below be met, a commercial license must be obtained from the producer:
+
+a. Multi-tenant service: Unless explicitly authorized by Hypit.AI in writing, you may not use the Hypit source code, or any derivative work of it, to operate a multi-tenant environment, or to offer Hypit's functionality to third parties as a hosted, managed, or software-as-a-service offering.
+    - Tenant Definition: Within the context of Hypit, one tenant corresponds to one workspace — the isolated set of projects, artifacts, credentials, and configuration belonging to a single party. Operating an environment in which two or more parties outside your own organization hold separate workspaces constitutes a multi-tenant service, whether or not a fee is charged.
+
+b. Commercial redistribution: Unless explicitly authorized by Hypit.AI in writing, you may not sell, license for a fee, or otherwise supply for commercial gain Hypit or any derivative work of it, whether standalone or as a component of, or bundled with, any product, application, package, or device provided to third parties.
+    - Forking, modifying, and publishing the source code of Hypit or a derivative work is permitted, provided the result is made available under the terms of this same license and is not supplied for commercial gain.
+
+    - Permitted without a commercial license under clauses (a) and (b): obtaining Hypit and running it yourself on your own infrastructure; using it for your own organization's work, including commercial work and work performed for your clients; and single-tenant deployments operated by and for one organization.
+
+c. LOGO and copyright information: In the process of using Hypit, you may not remove or modify the name, LOGO, or copyright information presented in the Hypit command-line interface, its generated run reports and manifests, or any user-facing surface derived from them. This restriction is inapplicable to uses of Hypit that do not surface these components to a user.
+
+2. As a contributor, you should agree that:
+
+a. The producer can adjust the open-source agreement to be more strict or relaxed as deemed necessary.
+b. Your contributed code may be used for commercial purposes, including but not limited to its cloud business operations.
+
+3. Ownership of output: The producer claims no rights in the content you create with Hypit. Videos, audio, images, manifests, and any other artifacts produced through your use of Hypit belong to you, and this license imposes no conditions on their use — including commercial use. Note that content generated by way of third-party model or service providers may additionally be subject to the terms of those providers.
+
+Apart from the specific conditions mentioned above, all other rights and restrictions follow the Apache License 2.0. Detailed information about the Apache License 2.0 can be found at http://www.apache.org/licenses/LICENSE-2.0.
+
+© 2026 Hypit.AI

package/README.md

@@ -0,0 +1,203 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/public/hypit-logo-light.svg">
+    <img alt="Hypit" src="./docs/public/hypit-logo-dark.svg" width="400" height="122">
+  </picture>
+</p>
+
+<h3 align="center">Clone any viral video with AI agents</h3>
+<p align="center">1 command, 100 variants, 100M views.</p>
+
+<p align="center">
+  <a href="https://hypit.ai"><strong>Demo</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://hypit.ai/quickstart/"><strong>Quickstart</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://hypit.ai/guide/develop/"><strong>Develop</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="./README.zh-CN.md"><strong>简体中文</strong></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/hypit-ai/hypit/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/hypit-ai/hypit?style=flat-square&color=FFD700&logo=github&logoColor=white&label=Stars"></a>
+  <a href="./package.json"><img alt="Node 22.12+" src="https://img.shields.io/badge/Node.js-22.12%2B-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white"></a>
+  <a href="./package.json"><img alt="pnpm 10.33" src="https://img.shields.io/badge/pnpm-10.33-F69220?style=flat-square&logo=pnpm&logoColor=white"></a>
+  <a href="./package.json"><img alt="TypeScript 5.9" src="https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white"></a>
+  <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0%20with%20conditions-E3B341?style=flat-square"></a>
+</p>
+
+<p align="center">
+  <a href="https://hypit.ai"><img alt="Visit our website" src="https://img.shields.io/badge/Visit%20our%20website-DF3C68?style=for-the-badge&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjI1Ny4wMyAyODcuNDggNDg2Ljk0IDQyNi4wNCI%2BPHBhdGggZmlsbD0iI2ZmZiIgZD0iTTczMy4wMDEsNDYyLjU5MmMtMTEuNDQtMTYuNTEtMzAuMjg1LTI2LjM0NC01MC4zNTMtMjYuMzQ0aC0xNzguNzA1Yy0yMy40OTMsMC00Ny42NzUsMTQuMjM0LTU2LjYyOCwzNS45NjdsLTU0LjA2NSwxNDUuMDUzYy04LjgsMjEuNTIzLTguNjg2LDQ2LjAxMSw0LjI0Nyw2NS4zNTIsMTIuOTksMTkuNDE4LDM3LjAzOCwzMC44OTcsNjAuMzk3LDMwLjg5N2gxNjQuNDljMjcuMDEzLDAsNTEuNDYzLTE2Ljk4OSw2MC45MTQtNDIuMjhsNTYuODAxLTE1Mi4yMjdjNy4wMjEtMTguODI1LDQuMzgxLTM5LjkwOC03LjA1OS01Ni4zOTl2LS4wMzhoLS4wMzh2LjAxOVpNNjMzLjk3OCw2NTIuODEzYy0xLjc5OCw0LjgyMS02LjQ4NSw4LjA3My0xMS42MzIsOC4wNzNoLTE1OS42NWMtOC4zMDMsMC0xMi43OC01LjM1Ny0xNC4zMjktNy42MzNzLTQuNzgzLTguNDc1LTEuNjA3LTE2LjE0N2w0NS42MjgtMTI2LjcyNWM0LjM4MS0xMi4xNDgsMTUuNDU4LTIwLjc5NiwyOC4zNTItMjEuNDY1LjYzMS0uMDM4LDEuMjgyLS4wMzgsMS45NTEtLjAzOGgxNDQuMjY5czIzLjkzMywyLjcxNywxNy43NzMsMjcuOTUxbC01MC43NTUsMTM2LjAwNGgwdi0uMDE5Wk0zNTYuMjUsNjIzLjEyMnMtNDIuNzc3LTIyLjE3My0zMy43ODYtNjIuNDgzbDU2Ljc2Mi0xNTcuMzE2YzkuMTQ1LTI1LjM0OSwzMy4yMTItNDIuMjYxLDYwLjE2OC00Mi4yNjFoMTgxLjc4NWMxMS45NTcsMCwyMy4xNDksNS43OTcsMzAuMDU1LDE1LjU3M2wyNi41NzMsMzcuNjVoLTIxNi4xMjVjLTE2LjY0NCwwLTMxLjU0NywxMC4zNS0zNy4zNDQsMjUuOTYxbC02OC4wODgsMTgyLjg5NWgwdi0uMDE5Wk0yOTIuMDY0LDU0OS41NDNzLTQyLjc5Ny0yMi4xNzMtMzMuNzg2LTYyLjQ4M2w1Ni43NjItMTU3LjMxNmM5LjE2NC0yNS4zNDksMzMuMjMxLTQyLjI2MSw2MC4xNjgtNDIuMjYxaDE3Mi4wMDljMTEuOTU3LDAsMjMuMTQ5LDUuNzk3LDMwLjA1NSwxNS41NzNsMjYuNTczLDM3LjY1aC0yMDYuMzExYy0xNi42NDQsMC0zMS41NDcsMTAuMzUtMzcuMzQ0LDI1Ljk2MWwtNjguMDg4LDE4Mi44OTVoLS4wMzh2LS4wMTlaIi8%2BPC9zdmc%2B"></a>
+  <a href="https://discord.gg/85hnyQnxpn"><img alt="Join our Discord" src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a>
+  <a href="https://t.me/hypit"><img alt="Join our Telegram" src="https://img.shields.io/badge/Join%20our%20Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  <a href="https://x.com/hypitai"><img alt="Follow @hypitai on X" src="https://img.shields.io/badge/Follow%20%40hypitai-000000?style=for-the-badge&logo=x&logoColor=white"></a>
+</p>
+
+<p align="center">
+  ⭐ <em>Help more people find Hypit and grow the community. Star this repo!</em>
+</p>
+
+## Hypit
+
+Hypit gives AI agents (Claude Code, Codex...) a language and system to create video. Drop in a video, and your agent clones it as a complete workflow: footage, captions, B-roll and effects, all anchored to words instead of seconds.
+
+**To be clear:** cloning a video is the fastest way in, not the only one. You can start from our templates, or just describe the video you want and your agent writes the workflow from scratch. Generation models are optional too: a workflow can compile captions, motion graphics and code-rendered visuals into a finished video without calling a single model, so a video can cost exactly $0.
+
+![SVML source and live video preview](https://github.com/user-attachments/assets/981c28e8-ddab-4164-85bc-03b5d71275dc)
+
+<p align="center"><em>SVML source on the left, with the corresponding video rendered live on the right.</em></p>
+
+## Install once
+
+```bash
+npx skills add hypit-ai/hypit -g
+```
+
+This installs the Skill. On first use, your agent checks for the Hypit executable and helps prepare
+it if needed. Your video project can live anywhere.
+
+## Examples
+
+### UGC
+
+[Generation source](examples/ranking-football/reference.svml) · [Run and production notes](examples/ranking-football/README.md)
+
+<table>
+  <tr>
+    <th width="16%">Reference</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/f573bdac-62da-4b5d-825d-54d5880a7026" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">Clones</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/3ffd9951-e423-4a48-ad8f-5c596627be69" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/eb62372d-2464-4a4b-83ee-41e227f99a8e" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/9ba050f6-355d-460c-b684-7344cf49c051" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>"GOAT DEBATE"</b> — a 20-second football tier list that puts Ronaldo in D and Messi in S. Two Seedance 2 Mini 720p trolling A-rolls, a 2K goth girl portrait and ten 1K brain-rot B-rolls by GPT Image 2, WhisperX word alignment, a sound-synced ranking board, color-box karaoke captions, buttery-smooth animation and catchy background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap the narrator to banana cat, flip the rankings and Ronaldo becomes GOAT, or replace all players with tech founders — same viral structure, different viral video.</p><p>Total cost: <b>$1.15</b>.</p></td>
+  </tr>
+</table>
+
+### Podcast
+
+[Generation source](examples/podcast/reference.svml) · [Run and production notes](examples/podcast/README.md)
+
+<table>
+  <tr>
+    <th width="16%">Reference</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/22df72b8-4831-4eb6-957d-676ae9b04f2d" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">Clones</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/9c14c5ae-bd12-4961-9d57-a46d3a2154c6" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/f44c653b-f520-4715-9530-4c2f42114387" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/92f9bf8b-4f83-4d9b-a0e8-ca27fab2cc94" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>"DAILY CREATINE"</b> — an 18-second podcast clip where a muscle barbie forces creatine on a skinny college kid. Three confrontational A-rolls and an aspirational lifestyle B-roll by Seedance 2 Mini 720p, two 2K AI character portraits and three 1K montage panels by GPT Image 2, WhisperX word alignment, split-screen interview layout, speaker-aware karaoke captions, a product-handoff moment and background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap both hosts to Pepe and Doge arguing about doggy arms, replace the creatine with retinol where a pretty boy roasts a tomboy's pores, or ditch the physical product for a CheatGPT app where a himbo jock out-GPAs a PhD student — same podcast format, three ad verticals.</p><p>Total cost: <b>$1.07</b>.</p></td>
+  </tr>
+</table>
+
+### Street Interview
+
+[Generation source](examples/interview/reference.svml) · [Run and production notes](examples/interview/README.md)
+
+<table>
+  <tr>
+    <th width="16%">Reference</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/666ad535-3231-44fb-b9bc-271817ae79de" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">Clones</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/c39a0425-2dcb-4709-b894-6a9423d351e3" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/8f71552c-0ad1-4d29-8c4e-3b937ab7c887" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/d9cab2e7-e08b-48ef-8d25-bc28ca9efc17" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>"NICE RIDE"</b> — a 26-second street interview where a mob wife drops three rules for making her first million. Three A-rolls by Seedance 2 Mini 720p, one 2K AI character portrait by GPT Image 2, WhisperX word alignment, head-tracked speaker-colored captions driven by face bounding boxes from Google Video Intelligence and YOLOv8 AnimeFace, a sound-synced emoji reveal board with color flashes and reveal sound effects, plus background music, concurrently rendered in 64 headless Chromium processes.</p><p>Three clones included: swap hosts to Wojak and Chad, translate everything to Spanish with exactly the same punchlines, or swap the Lambo for an F1 car where Ada explains to Leon how driving Uber led to an accidental Grand Prix win — same three-stage reveal, distinct street-interview remixes.</p><p>Total cost: <b>$1.09</b>.</p></td>
+  </tr>
+</table>
+
+## Use the Hypit skill
+
+The `/hypit` skill is available to coding agents. Start a session in any empty or existing project
+directory and ask it to create videos for you:
+
+```text
+/hypit Clone this video: /path/to/video
+```
+
+Or start without a reference video:
+
+```text
+/hypit Make a ranking video that puts Hypit in S tier.
+```
+
+Your agent can check the environment, request the credentials the video needs, generate the material, and build the finished composition.
+
+### **👉 [Get 100 FREE AI Avatars with unique voices](https://drive.google.com/drive/u/2/folders/18J9Fz7mkU3OQNJ-2Res3eIyFQ2cemIK5)**
+
+## Why Hypit
+
+- **Clone any video:** drop in a video, get the whole workflow — footage, captions, B-roll, effects. Not a script breakdown.
+- **One workflow, 100 variants:** the second video costs almost nothing; the hundredth is a loop.
+- **Pluggable components:** swap the host without touching the captions. Use the library, fork it, or write your own.
+- **Open source, $0:** no seat pricing, no per-render fees, no watermark. Arcads charges $220/mo, Creatify $39, before you render anything — but Hypit is $0.
+
+## What Hypit Can Build
+
+Drop in a video and your agent clones the whole workflow — or describe what you want and it writes one from scratch. Either way you get an editable, re-runnable composition, not a one-off render.
+
+- **Paid social ads** — clone a winning ad from the Meta Ad Library, swap in your product, ship 50 hook variants the same day. When it fatigues in two weeks, re-run with fresh openings; the body never changes.
+- **Viral clones** — any TikTok, Reel, or Short becomes a template. Swap the host, the hook, the product, the language, the aspect ratio.
+- **TikTok Shop and affiliate videos** — one format that converts, a new SKU every day. Swap the product, the price, the CTA; the structure that worked stays untouched.
+- **AI UGC and talking heads** — narration, word-level captions, B-roll, comment stickers, beat-synced cuts, all wired automatically.
+- **Podcast and interview clips** — split-screen layouts, speaker-aware captions, reaction overlays.
+- **Code-rendered videos** — visuals driven entirely by front-end code. Compiled from source, zero API calls, 0 dollars a video.
+- **Localized versions** — the same video in ten languages. Rewrite a line and the timing re-flows itself.
+
+## Stay Tuned with Us
+
+Star us, and you will receive all release notifications from GitHub without any delay!
+
+![Stay tuned with us](https://github.com/user-attachments/assets/cc929974-96b8-4166-b81d-008e130b0f24)
+
+## How to Contribute
+
+Pull requests are welcome, and documentation, examples and translations count as much as code. Pick
+up an open issue or open one for what you want to work on, and we will help you land it.
+[CONTRIBUTING.md](./CONTRIBUTING.md) has the setup, the checks CI runs and the pull request flow.
+
+Creating a component is ordinary video-production work, and the component normally stays with the
+video project that owns it. When its owner wants to share it, the same package can be handed off as
+a versioned tarball or published under the owner's npm scope or private registry. Proposals for a
+component maintained in Hypit's official Distribution begin with an issue describing the shared
+product need; official inclusion is separate from normal community sharing.
+
+The [Development Guide](https://hypit.ai/guide/develop/) covers the prerequisites, the daily
+commands and the repository layout.
+
+<table>
+  <tr>
+    <td>Bug reports</td>
+    <td><a href="https://github.com/hypit-ai/hypit/issues/new?labels=bug">Open an issue</a></td>
+  </tr>
+  <tr>
+    <td>Feature requests</td>
+    <td><a href="https://github.com/hypit-ai/hypit/issues/new?labels=enhancement">Open an issue</a></td>
+  </tr>
+  <tr>
+    <td>Questions</td>
+    <td><a href="https://discord.gg/85hnyQnxpn">Discord</a> or <a href="https://t.me/hypit">Telegram</a></td>
+  </tr>
+</table>
+
+## License
+
+Hypit is released under the [Hypit Open Source License](./LICENSE). The videos and other outputs you create belong to you; third-party models and services may have their own terms.

package/README.zh-CN.md

@@ -0,0 +1,195 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="./docs/public/hypit-logo-light.svg">
+    <img alt="Hypit" src="./docs/public/hypit-logo-dark.svg" width="400" height="122">
+  </picture>
+</p>
+
+<h3 align="center">让 AI Agent 复刻任何爆款视频</h3>
+<p align="center">一条命令，100 个变体，1 亿播放量。</p>
+
+<p align="center">
+  <a href="https://hypit.ai"><strong>Demo</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://hypit.ai/zh/quickstart/"><strong>快速开始</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="https://hypit.ai/zh/guide/develop/"><strong>开发指南</strong></a>
+  &nbsp;&bull;&nbsp;
+  <a href="./README.md"><strong>English</strong></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/hypit-ai/hypit/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/hypit-ai/hypit?style=flat-square&color=FFD700&logo=github&logoColor=white&label=Stars"></a>
+  <a href="./package.json"><img alt="Node 22.12+" src="https://img.shields.io/badge/Node.js-22.12%2B-5FA04E?style=flat-square&logo=nodedotjs&logoColor=white"></a>
+  <a href="./package.json"><img alt="pnpm 10.33" src="https://img.shields.io/badge/pnpm-10.33-F69220?style=flat-square&logo=pnpm&logoColor=white"></a>
+  <a href="./package.json"><img alt="TypeScript 5.9" src="https://img.shields.io/badge/TypeScript-5.9-3178C6?style=flat-square&logo=typescript&logoColor=white"></a>
+  <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0%20with%20conditions-E3B341?style=flat-square"></a>
+</p>
+
+<p align="center">
+  <a href="https://hypit.ai"><img alt="Visit our website" src="https://img.shields.io/badge/Visit%20our%20website-DF3C68?style=for-the-badge&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjI1Ny4wMyAyODcuNDggNDg2Ljk0IDQyNi4wNCI%2BPHBhdGggZmlsbD0iI2ZmZiIgZD0iTTczMy4wMDEsNDYyLjU5MmMtMTEuNDQtMTYuNTEtMzAuMjg1LTI2LjM0NC01MC4zNTMtMjYuMzQ0aC0xNzguNzA1Yy0yMy40OTMsMC00Ny42NzUsMTQuMjM0LTU2LjYyOCwzNS45NjdsLTU0LjA2NSwxNDUuMDUzYy04LjgsMjEuNTIzLTguNjg2LDQ2LjAxMSw0LjI0Nyw2NS4zNTIsMTIuOTksMTkuNDE4LDM3LjAzOCwzMC44OTcsNjAuMzk3LDMwLjg5N2gxNjQuNDljMjcuMDEzLDAsNTEuNDYzLTE2Ljk4OSw2MC45MTQtNDIuMjhsNTYuODAxLTE1Mi4yMjdjNy4wMjEtMTguODI1LDQuMzgxLTM5LjkwOC03LjA1OS01Ni4zOTl2LS4wMzhoLS4wMzh2LjAxOVpNNjMzLjk3OCw2NTIuODEzYy0xLjc5OCw0LjgyMS02LjQ4NSw4LjA3My0xMS42MzIsOC4wNzNoLTE1OS42NWMtOC4zMDMsMC0xMi43OC01LjM1Ny0xNC4zMjktNy42MzNzLTQuNzgzLTguNDc1LTEuNjA3LTE2LjE0N2w0NS42MjgtMTI2LjcyNWM0LjM4MS0xMi4xNDgsMTUuNDU4LTIwLjc5NiwyOC4zNTItMjEuNDY1LjYzMS0uMDM4LDEuMjgyLS4wMzgsMS45NTEtLjAzOGgxNDQuMjY5czIzLjkzMywyLjcxNywxNy43NzMsMjcuOTUxbC01MC43NTUsMTM2LjAwNGgwdi0uMDE5Wk0zNTYuMjUsNjIzLjEyMnMtNDIuNzc3LTIyLjE3My0zMy43ODYtNjIuNDgzbDU2Ljc2Mi0xNTcuMzE2YzkuMTQ1LTI1LjM0OSwzMy4yMTItNDIuMjYxLDYwLjE2OC00Mi4yNjFoMTgxLjc4NWMxMS45NTcsMCwyMy4xNDksNS43OTcsMzAuMDU1LDE1LjU3M2wyNi41NzMsMzcuNjVoLTIxNi4xMjVjLTE2LjY0NCwwLTMxLjU0NywxMC4zNS0zNy4zNDQsMjUuOTYxbC02OC4wODgsMTgyLjg5NWgwdi0uMDE5Wk0yOTIuMDY0LDU0OS41NDNzLTQyLjc5Ny0yMi4xNzMtMzMuNzg2LTYyLjQ4M2w1Ni43NjItMTU3LjMxNmM5LjE2NC0yNS4zNDksMzMuMjMxLTQyLjI2MSw2MC4xNjgtNDIuMjYxaDE3Mi4wMDljMTEuOTU3LDAsMjMuMTQ5LDUuNzk3LDMwLjA1NSwxNS41NzNsMjYuNTczLDM3LjY1aC0yMDYuMzExYy0xNi42NDQsMC0zMS41NDcsMTAuMzUtMzcuMzQ0LDI1Ljk2MWwtNjguMDg4LDE4Mi44OTVoLS4wMzh2LS4wMTlaIi8%2BPC9zdmc%2B"></a>
+  <a href="https://discord.gg/85hnyQnxpn"><img alt="Join our Discord" src="https://img.shields.io/badge/Join%20our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a>
+  <a href="https://t.me/hypit"><img alt="Join our Telegram" src="https://img.shields.io/badge/Join%20our%20Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white"></a>
+  <a href="https://x.com/hypitai"><img alt="Follow @hypitai on X" src="https://img.shields.io/badge/Follow%20%40hypitai-000000?style=for-the-badge&logo=x&logoColor=white"></a>
+</p>
+
+<p align="center">
+  ⭐ <em>让更多人发现 Hypit，一起壮大社区。给仓库点个 Star！</em>
+</p>
+
+## Hypit
+
+Hypit 为 AI Agent（Claude Code、Codex 等）提供了一套制作视频的语言和系统。给它一条视频，Agent 就能把它复刻成一份完整的 workflow：画面、字幕、B-roll、特效，全部锚定在词上，而不是秒上。
+
+**需要说明的是：** 复刻视频是最快的入口，但不是唯一的入口。你可以从我们的模板开始，也可以描述你想要的视频，让 Agent 从零写出一份 workflow。生成模型同样不是必需的：字幕、动效和代码渲染的画面，不调用任何模型也能编译成一条成片，一条视频的成本可以正好是 $0。
+
+![SVML 源文件与实时视频预览](https://github.com/user-attachments/assets/981c28e8-ddab-4164-85bc-03b5d71275dc)
+
+<p align="center"><em>左侧是 SVML 源文件，右侧实时呈现对应视频。</em></p>
+
+## 只安装一次
+
+```bash
+npx skills add hypit-ai/hypit -g
+```
+
+这条命令安装 Skill。首次使用时，Agent 会检查 Hypit 可执行程序，并按需协助安装。
+视频项目可以放在任意位置。
+
+## 示例
+
+### UGC
+
+[Generation source](examples/ranking-football/reference.svml) · [Run and production notes](examples/ranking-football/README.md)
+
+<table>
+  <tr>
+    <th width="16%">参考视频</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/f573bdac-62da-4b5d-825d-54d5880a7026" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">复刻视频</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/3ffd9951-e423-4a48-ad8f-5c596627be69" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/eb62372d-2464-4a4b-83ee-41e227f99a8e" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/9ba050f6-355d-460c-b684-7344cf49c051" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>“GOAT DEBATE”</b>——一条 20 秒的足球 Tier List，把 Ronaldo 排进 D 级，把 Messi 排进 S 级。A-roll 是两段 Seedance 2 Mini 生成的 720p 吐槽片段，B-roll 是 GPT Image 2 生成的一张 2K 哥特女孩肖像和十张 1K 脑腐图；WhisperX 负责逐词对齐，排行榜跟着音效逐条落位，再配上彩色词盒卡拉 OK 字幕、丝滑的动画和抓耳的背景音乐，最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本：把解说员换成香蕉猫；翻转排名，让 Ronaldo 成为 GOAT；把所有球员换成科技公司创始人。同一套爆款结构，可以产出完全不同的爆款视频。</p><p>总成本：<b>$1.15</b>。</p></td>
+  </tr>
+</table>
+
+### 播客
+
+[Generation source](examples/podcast/reference.svml) · [Run and production notes](examples/podcast/README.md)
+
+<table>
+  <tr>
+    <th width="16%">参考视频</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/22df72b8-4831-4eb6-957d-676ae9b04f2d" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">复刻视频</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/9c14c5ae-bd12-4961-9d57-a46d3a2154c6" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/f44c653b-f520-4715-9530-4c2f42114387" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/92f9bf8b-4f83-4d9b-a0e8-ca27fab2cc94" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>“DAILY CREATINE”</b>——一条 18 秒的播客片段，肌肉芭比向一个瘦弱的大学生强推肌酸。A-roll 是 Seedance 2 Mini 生成的三段 720p 对峙镜头，外加一段展示理想生活方式的 B-roll；图像是 GPT Image 2 生成的两张 2K AI 角色肖像和三张 1K 蒙太奇画面。WhisperX 负责逐词对齐，再配上分屏访谈版式、区分说话人的卡拉 OK 字幕、产品递出的瞬间和背景音乐，最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本：把两位主播换成 Pepe 和 Doge，争论狗狗手臂；把肌酸换成视黄醇，让漂亮男孩吐槽假小子的毛孔；把实体产品换成 CheatGPT 应用，让头脑简单的体育生绩点碾压博士生。同一套播客形式，三个广告垂类。</p><p>总成本：<b>$1.07</b>。</p></td>
+  </tr>
+</table>
+
+### 街头采访
+
+[Generation source](examples/interview/reference.svml) · [Run and production notes](examples/interview/README.md)
+
+<table>
+  <tr>
+    <th width="16%">参考视频</th>
+    <td width="28%"></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/666ad535-3231-44fb-b9bc-271817ae79de" controls muted></video></td>
+    <td width="28%"></td>
+  </tr>
+  <tr>
+    <th width="16%">复刻视频</th>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/c39a0425-2dcb-4709-b894-6a9423d351e3" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/8f71552c-0ad1-4d29-8c4e-3b937ab7c887" controls muted></video></td>
+    <td width="28%"><video src="https://github.com/user-attachments/assets/d9cab2e7-e08b-48ef-8d25-bc28ca9efc17" controls muted></video></td>
+  </tr>
+  <tr>
+    <td colspan="4"><p><b>“NICE RIDE”</b>——一条 26 秒的街头采访，黑帮太太分享赚到第一个一百万的三条规则。三段由 Seedance 2 Mini 生成的 720p A-roll，一张由 GPT Image 2 生成的 2K AI 角色肖像；WhisperX 负责逐词对齐，再利用 Google Video Intelligence 和 YOLOv8 AnimeFace 提供的人脸边界框，驱动跟随人脸的说话人专属彩色字幕；配合跟音效同步的表情符号揭示板、彩色闪烁、揭示音效和背景音乐，最后由 64 个无头 Chromium 进程并发渲染。</p><p>上面给出了三个复刻版本：把主播换成 Wojak 和 Chad；把所有内容翻译成西班牙语，同时保持完全相同的 punchline；或者把兰博基尼换成 F1 赛车，让 Ada 向 Leon 解释自己如何因为开 Uber 意外赢得大奖赛。同样的三阶段揭示结构，三种不同的街头采访混剪。</p><p>总成本：<b>$1.09</b>。</p></td>
+  </tr>
+</table>
+
+## 使用 Hypit skill
+
+编程 Agent 可以直接使用 `/hypit` skill。在任意空目录或现有项目目录中开启会话，让 Agent 为你创建视频：
+
+```text
+/hypit 复刻这个视频：/path/to/video
+```
+
+也可以不提供参考视频，直接从描述开始：
+
+```text
+/hypit 做一个 ranking 视频，把 Hypit 排到 S 级。
+```
+
+Agent 会检查环境，索要这条视频需要的凭据，生成素材并构建成片。
+
+### **👉 [免费获得 100 个拥有独特音色的 AI 人物形象](https://drive.google.com/drive/u/2/folders/18J9Fz7mkU3OQNJ-2Res3eIyFQ2cemIK5)**
+
+## 为什么选择 Hypit
+
+- **真的能 Clone：** 丢一条视频进来，拿到整份 workflow —— 画面、字幕、B-roll、特效。不是拆解脚本。
+- **一份 workflow，100 个变体：** 第二条几乎不花钱，第一百条只是跑个循环。
+- **可插拔组件：** 换主播不动字幕。用组件库、fork 一个，或自己写。
+- **开源，一条视频 0 元：** 不按人头收费，不按条收费，没有水印。Arcads 每月 220 美元，Creatify 39 美元，而这是你还没渲染任何东西之前 —— 但 Hypit 是 0 元。
+
+## Hypit 能构建什么
+
+丢一条视频进来，Agent 把整套 workflow 克隆下来；或者直接描述你想要的视频，让它从零写一份。拿到的都是可编辑、可重跑的工作流，而不是一次性的成片。
+
+- **信息流广告** —— 从 Meta 广告库拉一条正在跑的广告，克隆成 workflow，换上你的产品，当天发出 50 个 Hook 变体。两周后创意衰退，换一批开头重跑，主体一个字不动。
+- **复刻爆款** —— 任何 TikTok、Reels、Shorts 都能变成模板：换主播、换 Hook、换产品、换语言、换画幅。
+- **带货视频** —— 一个跑通的格式，每天换一个 SKU。换产品、换价格、换 CTA，转化率跑出来的结构原封不动。
+- **AI UGC 与口播** —— 配音、词级字幕、B-roll、评论区贴纸、卡点剪辑，全部自动挂好。
+- **播客与采访切片** —— 分屏布局、区分说话人的字幕、反应特效。
+- **代码渲染的视频** —— 画面完全由前端代码驱动。全部由源码编译，零 API 调用，一条 0 元。
+- **多语言版本** —— 同一条视频十种语言。改一句台词，时间轴自己重排。
+
+## 关注我们
+
+给我们点个 Star，即可第一时间收到 GitHub 的所有版本发布通知！
+
+![Stay tuned with us](https://github.com/user-attachments/assets/cc929974-96b8-4166-b81d-008e130b0f24)
+
+## 贡献指南
+
+欢迎提交 Pull Request，文档、示例和翻译与代码同样重要。可以认领一个已有的 issue，也可以为你想做的事新开一个，我们会协助你把它合并进来。环境准备、CI 会跑的检查和 Pull Request 流程见 [CONTRIBUTING.zh-CN.md](./CONTRIBUTING.zh-CN.md)。
+
+创建组件是正常的视频制作工作，组件通常留在拥有它的视频项目中。所有者希望分享时，可以把同一份包作为版本化 tarball 直接交付，也可以发布到自己的 npm scope 或私有 registry。希望某个组件由 Hypit 官方 Distribution 维护时，先通过 issue 说明它解决的共同产品需求；官方收录与普通的社区分享是两件事。
+
+[开发指南](https://hypit.ai/zh/guide/develop/)说明了前置条件、日常命令和仓库结构。
+
+<table>
+  <tr>
+    <td>缺陷报告</td>
+    <td><a href="https://github.com/hypit-ai/hypit/issues/new?labels=bug">提交 issue</a></td>
+  </tr>
+  <tr>
+    <td>功能请求</td>
+    <td><a href="https://github.com/hypit-ai/hypit/issues/new?labels=enhancement">提交 issue</a></td>
+  </tr>
+  <tr>
+    <td>问题咨询</td>
+    <td><a href="https://discord.gg/85hnyQnxpn">Discord</a> 或 <a href="https://t.me/hypit">Telegram</a></td>
+  </tr>
+</table>
+
+## 许可证
+
+Hypit 采用 [Hypit 开源许可证](./LICENSE)。你创作的视频和其他产出归你所有；第三方模型与服务可能另有条款。

package/bin/hypit.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+import { register } from "tsx/esm/api";
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+if (process.argv.length === 3 && ["--version", "-v"].includes(process.argv[2])) {
+  const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+  console.log(manifest.version);
+  process.exit(0);
+}
+
+const emitWarning = process.emitWarning;
+process.emitWarning = function hypitWarning(warning, ...args) {
+  const message = warning instanceof Error ? warning.message : String(warning);
+  if (message === "SQLite is an experimental feature and might change at any time") return;
+  return emitWarning.call(process, warning, ...args);
+};
+
+const distributionRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+process.env.HYPIT_CLI_LAUNCHER ??= import.meta.filename;
+process.env.HYPIT_DISTRIBUTION_ROOT ??= distributionRoot;
+register();
+const {
+  installDistributionPackageResolution,
+  installExternalPackageResolution,
+} = await import("../packages/package-loader-node/src/distribution-resolution.ts");
+installDistributionPackageResolution([distributionRoot]);
+const { hypitHostPackageRoot } = await import("../packages/runtime-host-node/src/index.ts");
+installExternalPackageResolution([hypitHostPackageRoot()]);
+const args = process.argv.slice(2);
+if (args[0] === "studio" || (args[0] === "help" && args[1] === "studio")) {
+  const { runStudio } = await import("../packages/studio/start.ts");
+  try {
+    await runStudio(args[0] === "help" ? ["--help"] : args.slice(1).filter((arg) => arg !== "--debug"), {
+      write: (text) => process.stdout.write(text),
+    });
+  } catch (error) {
+    const { renderCliError } = await import("../packages/cli/src/index.ts");
+    process.stderr.write(renderCliError(error, { debug: args.includes("--debug") }));
+    process.exitCode = 1;
+  }
+} else {
+  await import("../packages/video-cli/src/cli.ts");
+}

package/dist/public/artifact.d.ts

@@ -0,0 +1,75 @@
+type ModuleRef = {
+    readonly name: string;
+    readonly version: string;
+};
+/**
+ * A Type is its owning Module and its name, and nothing else is compared. Two Types whose values
+ * carry identical shapes are distinct, so one is refused where the other is declared — there is no
+ * structural fallback to fall back to.
+ */
+type TypeRef = {
+    readonly module: ModuleRef;
+    readonly name: string;
+};
+type CapabilityRef = {
+    readonly module: ModuleRef;
+    readonly name: string;
+};
+
+type ModuleDependency = {
+    readonly module: ModuleRef;
+};
+type TypeDeclaration = {
+    readonly name: string;
+};
+type PortDeclaration = {
+    readonly name: string;
+    readonly type: TypeRef;
+};
+type NeedPortDeclaration = {
+    readonly name: string;
+    readonly capability: CapabilityRef;
+    readonly returns: TypeRef;
+};
+type CapabilityDeclaration = {
+    readonly name: string;
+    readonly returns: TypeRef;
+};
+type ProducerDeclaration = {
+    readonly name: string;
+    readonly inputs: readonly PortDeclaration[];
+    readonly outputs: readonly PortDeclaration[];
+    readonly needs: readonly NeedPortDeclaration[];
+};
+type ModuleManifest = {
+    readonly format: "hypit.module@1";
+    readonly name: string;
+    readonly version: string;
+    readonly dependencies: readonly ModuleDependency[];
+    readonly types: readonly TypeDeclaration[];
+    readonly capabilities: readonly CapabilityDeclaration[];
+    readonly producers: readonly ProducerDeclaration[];
+};
+
+declare const artifactModuleRef: {
+    readonly name: "@hypit/artifact";
+    readonly version: "1";
+};
+declare const artifactTypes: {
+    blob: {
+        module: {
+            readonly name: "@hypit/artifact";
+            readonly version: "1";
+        };
+        name: string;
+    };
+};
+declare const artifactManifest: ModuleManifest;
+declare const artifactDependency: {
+    readonly module: {
+        readonly name: "@hypit/artifact";
+        readonly version: "1";
+    };
+};
+
+export { artifactDependency, artifactManifest, artifactModuleRef, artifactTypes };