@hypit/hypit 0.0.1 → 0.1.1

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,142 @@
+<p align="center">
+  <img alt="Hypit" src="https://raw.githubusercontent.com/hypit-ai/hypit/main/docs/public/hypit-logo-dark.svg" width="400" height="122">
+</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="https://github.com/hypit-ai/hypit/blob/main/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="https://github.com/hypit-ai/hypit/blob/main/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="https://github.com/hypit-ai/hypit/blob/main/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="https://github.com/hypit-ai/hypit/blob/main/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="https://github.com/hypit-ai/hypit/blob/main/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://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/demo.gif)
+
+<p align="center"><em>SVML source on the left, with the corresponding video rendered live on the right.</em></p>
+
+## Install once
+
+Install the Hypit CLI (Node.js 22.12 or newer):
+
+```bash
+npm install -g @hypit/hypit
+```
+
+Add the Skill to your coding agent:
+
+```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.
+
+[Watch the complete video examples on GitHub](https://github.com/hypit-ai/hypit#examples).
+
+## 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://storage.googleapis.com/hypit-public-assets/showcase/2026-09-09/star.gif)
+
+## 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](https://github.com/hypit-ai/hypit/blob/main/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](https://github.com/hypit-ai/hypit/blob/main/LICENSE). The videos and other outputs you create belong to you; third-party models and services may have their own terms.

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 };