Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
docs(skill): remove local whisperx setup path
rpone389714f8cd3a
diff --git a/docs/guide/skill.md b/docs/guide/skill.mdindex a4b3dab6..3e401b6f 100644--- a/docs/guide/skill.md+++ b/docs/guide/skill.md@@ -58,7 +58,7 @@ The standard sequence is:```textselect Runtime Profile → check HypiHub credential → explain and run OAuth when missing-→ confirm login → hypit runtime up → verify WhisperX/other programs+→ confirm login → hypit runtime up → verify HypiHub alignment/other programs→ only then inspect media, call Gemini, author Source or Build```@@ -238,7 +238,9 @@ spending. `hypit build` is submitted only after explicit cost approval.1. Select the Distribution, project root and Runtime Profile, then create `route_state`.2. Before inspecting examples or freezing the brief, check the `hypihub.default` credential. If the writable HypiHub OS credential is missing, explain that OAuth avoids copying an API key and run `hypit auth login hypihub.default --runtime hypit.runtime.json`; an account without an active subscription can purchase one at hypit.ai.-3. Run `hypit runtime up` and confirm WhisperX and every other selected program are healthy. Do not enter brief, vocabulary or Source work before this gate is complete.+3. Run `hypit runtime up` and confirm the HypiHub WhisperX alignment model is reachable through the+ selected Endpoint, along with every other selected program. Do not enter brief, vocabulary or+ Source work before this gate is complete.4. When vocabulary inspection proves a real gap, pause Source authoring and enter the project-package branch: create `packages/<slug>/`, write `package.json` and activation first, then implement the Manifest, Types, Producers, Validators, Surface/decoder, Fragment, README and preview. Install, import and pass `validate_local_author_packages`, `preview_check` and `layout_check` before returning to this route.```textdiff --git a/docs/zh/guide/skill.md b/docs/zh/guide/skill.mdindex fb248246..5f03cd94 100644--- a/docs/zh/guide/skill.md+++ b/docs/zh/guide/skill.md@@ -54,7 +54,7 @@ Provider,也不要求用户复制粘贴 API key。```text选择 Runtime Profile → 检查 HypiHub 凭据 → 缺失时说明并执行 OAuth 登录-→ 确认登录成功 → hypit runtime up → 检查 WhisperX/其他程序健康+→ 确认登录成功 → hypit runtime up → 检查 HypiHub 对齐能力/其他程序→ 才能读媒体、调用 Gemini、写 Source 或 Build```@@ -203,7 +203,7 @@ Studio 打开当前 Run。Studio 确认是付费前对结构的人工确认,1. 选择 Distribution、项目根目录和 Runtime Profile,建立 `route_state`。2. 在检查 examples 或写 brief 前,检查 `hypihub.default` 的凭据。没有可写的 HypiHub OS 凭据时,说明 OAuth 不需要复制 API key,并由 agent 执行 `hypit auth login hypihub.default --runtime hypit.runtime.json`;无有效订阅的账号可在 hypit.ai 购买。-3. 运行 `hypit runtime up`,确认 WhisperX 和 Runtime Profile 中的其他程序健康;环境未完成时不能进入 brief、词汇或 Source 阶段。+3. 运行 `hypit runtime up`,确认 HypiHub WhisperX 对齐模型可通过选定 Endpoint 访问,并确认 Runtime Profile 中的其他程序健康;环境未完成时不能进入 brief、词汇或 Source 阶段。4. 组件出现真实词汇缺口时,暂停写 Source,转入“项目本地包”分支:在项目 `packages/<slug>/` 创建包,先写 `package.json` 与 activation,再完成 Manifest、Types、Producers、Validators、Surface/decoder、Fragment、README 和 preview;安装、导入并通过 `validate_local_author_packages`、`preview_check`、`layout_check` 后,才能回到本路线。```text@@ -235,7 +235,7 @@ environment → brief-frozen → examples/格式/craft 决策#### 路径入口与前置1. 先选择项目、Runtime Profile 和 observer,并建立 `route_state`;不要先读取或复制参考视频。-2. 检查 HypiHub OAuth。凭据缺失时由 agent 说明原因并执行 `hypit auth login hypihub.default --runtime hypit.runtime.json`,然后运行 `hypit runtime up`,确认 WhisperX 已就绪后才能 `prepare_reference`、观察或调用 Gemini。+2. 检查 HypiHub OAuth。凭据缺失时由 agent 说明原因并执行 `hypit auth login hypihub.default --runtime hypit.runtime.json`,然后确认 HypiHub WhisperX 对齐模型可访问,之后才能 `prepare_reference`、观察或调用 Gemini。3. 参考证据完成后再枚举组件。确认词汇缺口时,按原创路径的项目本地包分支实现并验证完整包(`package.json`、activation、Manifest、Types、Producers、Validators、Surface/decoder、Fragment、README、preview),不能修改安装包或直接复制参考素材。复刻采用严格的“证据优先”顺序:整条复刻路径都禁止读取仓库 `examples/` 下的项目,包括完整的diff --git a/skills/hypit/SKILL.md b/skills/hypit/SKILL.mdindex c1f80699..ab56468d 100644--- a/skills/hypit/SKILL.md+++ b/skills/hypit/SKILL.md@@ -70,8 +70,8 @@ managed program installed and healthy. Credential setup is part of this gate: dewithout asking the author to choose, run the login yourself when the selected HypiHub OS credential ismissing, and continue only after it succeeds. Only when the author explicitly asks to use their ownprovider key may you configure that less-recommended path instead. Run the required Runtime provisioning-and health checks; the HypiHub WhisperX alignment model must be reachable through the selected Endpoint-and the profile must report alignment ready. Do this before+and health checks; the HypiHub WhisperX alignment model must be reachable through the selected Endpoint.+Do this beforeinspecting media or examples, preparing a reference, choosing an observer, freezing a brief, readingvocabulary, writing Source, previewing, or building.diff --git a/skills/hypit/references/environment.md b/skills/hypit/references/environment.mdindex 5a893cc5..36de5b32 100644--- a/skills/hypit/references/environment.md+++ b/skills/hypit/references/environment.md@@ -155,7 +155,7 @@ shell:`set -a; [ ! -f <checkout-root>/.env ] || . <checkout-root>/.env; [ ! -f <project-root>/.env ] || . <project-root>/.env; set +a`.When these values satisfy the selected observer/Provider, do not ask the author for them again.`uv` is required only when the selected Runtime Profile uses a managed Python program such as-WhisperX or OpenCV.+OpenCV.Reconstructing a video given as a link rather than as a file needs `uv` too: `yt-dlp` is pinned under`services/yt-dlp` and run from there, so the version is the repository's rather than the machine's.`prepare_reference` names what is missing when a link is passed without it.@@ -175,17 +175,16 @@ Managed programs are machine-level installations, separate from both Distributio- macOS: `~/Library/Application Support/Hypit/programs/`- Windows: `%LOCALAPPDATA%\Hypit\programs\`-WhisperX, for example, lives under `programs/whisperx/`; OpenCV under-`programs/image-opencv/`. Service process records and logs live with the program. Project Build and-Worker state remains under `<project>/.hypit/`.+Managed service process records and logs live with the program. Project Build and Worker state remains+under `<project>/.hypit/`.Reference-video state sits beside the Distribution, at `.hypit/reference-video-tools/<reference-id>/`.Commands may run from any directory; the tool locates this canonical state from the selectedDistribution. It is keyed by the video, so two reconstructions of one file sharethe observations it cost money to make; each command reports the root it used.-This split is why opening a second project cannot install WhisperX again, and why updating the npm-Distribution does not overwrite a Python environment or a user's project-local component.+This split is why updating the npm Distribution does not overwrite a managed program environment or a+user's project-local component.The sibling machine npm package home is:diff --git a/skills/hypit/references/host-setup.md b/skills/hypit/references/host-setup.mdindex 97e3367e..2d0d1b7b 100644--- a/skills/hypit/references/host-setup.md+++ b/skills/hypit/references/host-setup.md@@ -1,7 +1,7 @@# Host setup-Installing and repairing the host toolchain a Hypit route depends on: FFmpeg, `uv`, the managed-WhisperX service, machine npm packages, and Distribution updates.+Installing and repairing the host toolchain a Hypit route depends on: FFmpeg, machine npm packages,+and Distribution updates.## General machine probe@@ -35,132 +35,6 @@ ffprobe -versionDo not install FFmpeg into an author project or rely on a temporary download directory; theexecutables are host prerequisites shared by Hypit projects.-## Install WhisperX prerequisites on Windows--Install `uv` with the host package manager, then let `uv` install the pinned Python interpreter.-Use Windows 10 or 11 x64 in PowerShell:--```powershell-winget install --id astral-sh.uv -e-uv --version-uv python install 3.13-```--Open a new PowerShell session if `uv` is not immediately on `PATH` after the Winget install.--Windows-specific checks before provisioning:--```powershell-Get-Command uv, ffmpeg, ffprobe-uv --version-ffmpeg -version-ffprobe -version-```--If the Hypit contributor checkout already contains a host toolchain (for example under-`.tools\ffmpeg-extract\...\bin`), prepend that `bin` directory to `$env:Path` for the current-PowerShell process before running media commands. Do not copy those executables into an author-project, and do not assume that a repository-local path is visible in a new shell.--## Install WhisperX prerequisites on macOS--Install `uv` with the host package manager, then let `uv` install the pinned Python interpreter.-Use macOS 13 or newer:--```bash-brew install uv-uv --version-uv python install 3.13-```--If Homebrew is not installed, install `uv` using Astral's current official installation method;-do not improvise a Python `pip install` for this managed-program workflow.--## Let Hypit install and run WhisperX--The project Runtime Profile may select the local WhisperX Endpoint only when the author explicitly-chooses the local fallback. The default Skill path uses HypiHub's WhisperX alignment Endpoint. A-minimal local endpoint inside the-profile's `runtime.config.endpoints` is:--```json-"whisperx.local": {- "use": "@hypit/provider-whisperx-local",- "config": { "defaultConcurrency": 1 }-}-```--Then select and provision the Profile with the chosen Hypit launcher:--```text-hypit runtime use hypit.runtime.json-hypit runtime up-hypit runtime status-hypit doctor-```--`runtime up` owns the WhisperX installation: it creates or reuses the managed environment in the-machine Program Home, installs the locked service, prepares NLTK `punkt_tab`, starts the loopback-service on `127.0.0.1:8765`, and then starts the Worker. The first start may download the selected-Whisper and language-alignment model weights, so it can take substantially longer than later starts.-Do not run `uv sync` in an author project and do not install the `whisperx` Python package by hand.--`runtime up` printing `Ready whisperx` reports that the local service answered its health probe.--`runtime up` probes each selected program. It creates that program's environment only when absent or-unhealthy, then reuses it across projects and sessions. It never runs `uv sync` merely because a new-project or Runtime Worker started.--### The health check fails--Do not reinstall Python packages: poll rather than launching a second copy, and read-`hypit runtime logs`. The managed WhisperX log is also at-`$env:LOCALAPPDATA\Hypit\programs\whisperx\program.log`, with the service's error stream beside it-in `program.err.log`.--Verify a running service with `hypit programs status` or `hypit doctor`. If preparation fails, read-`hypit runtime logs`; for a contributor checkout only, `services/whisperx/README.md` contains the-manual `uv sync --frozen`, prepare and check commands used to diagnose the packaged service.--### The log reports a missing `torchcodec` DLL--The log may contain a `torchcodec` warning about missing `libtorchcodec_core*.dll`, especially when-the host FFmpeg build is newer than the versions supported by that optional decoder. The warning is-diagnostic only: accept the service only after `/health` answers and a real Hypit transcription-request succeeds. Do not repair it with an author-project `pip install`; keep the Runtime-managed-environment authoritative.--### NLTK `punkt_tab` was blocked by a proxy or SSRF policy--If `runtime up` reports that NLTK `punkt_tab` is missing because Python's downloader was blocked by-a proxy or SSRF policy, install the same archive from NLTK's official data repository into the-managed WhisperX data root, then run `hypit runtime up` again. Do this only for that explicit network-failure; ordinary installs stay Runtime-managed.--Windows PowerShell:--```powershell-$whisperxData = Join-Path $env:LOCALAPPDATA "Hypit\programs\whisperx\nltk_data"-$download = Join-Path $env:TEMP ("hypit-punkt-" + [guid]::NewGuid().ToString("N"))-New-Item -ItemType Directory -Path $download | Out-Null-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/nltk/nltk_data/gh-pages/packages/tokenizers/punkt_tab.zip" -OutFile (Join-Path $download "punkt_tab.zip")-New-Item -ItemType Directory -Path (Join-Path $whisperxData "tokenizers") -Force | Out-Null-Expand-Archive -LiteralPath (Join-Path $download "punkt_tab.zip") -DestinationPath (Join-Path $whisperxData "tokenizers") -Force-hypit runtime up-```--macOS:--```bash-whisperx_data="$HOME/Library/Application Support/Hypit/programs/whisperx/nltk_data"-download_dir="$(mktemp -d)"-mkdir -p "$whisperx_data/tokenizers"-curl -L "https://raw.githubusercontent.com/nltk/nltk_data/gh-pages/packages/tokenizers/punkt_tab.zip" \- -o "$download_dir/punkt_tab.zip"-unzip -q "$download_dir/punkt_tab.zip" -d "$whisperx_data/tokenizers"-hypit runtime up-```-## A package reports a missing optional dependencyUpstream npm dependencies follow the same machine-level lifetime as managed programs. Thediff --git a/skills/hypit/references/reconstruction/evidence.md b/skills/hypit/references/reconstruction/evidence.mdindex 4a65b5e6..b5dd284a 100644--- a/skills/hypit/references/reconstruction/evidence.md+++ b/skills/hypit/references/reconstruction/evidence.md@@ -57,8 +57,7 @@ to transcribe.`{ text, start_seconds, end_seconds, score }`. If the HypiHub WhisperX model is unavailable, the tool reports`status: "unavailable"` with a `reason`. Under the Skill's hard environment gate, do not continue fromthat result: confirm HypiHub OAuth and that the selected model exposes `transcriptions`, then prepare-the reference again. `../host-setup.md` covers the explicitly selected local fallback when it is not-enough to rely on the remote endpoint.+the reference again.When a completed preparation stage must be rerun, use one small `--redo` value:diff --git a/skills/hypit/references/runtime.md b/skills/hypit/references/runtime.mdindex 29495ed4..20c569f2 100644--- a/skills/hypit/references/runtime.md+++ b/skills/hypit/references/runtime.md@@ -58,9 +58,8 @@ including MiMo VoiceDesign. Select KIE, Vertex, official MiMo or another BYOK Prauthor explicitly asks not to use HypiHub or explicitly selects that Provider.Bind `@hypit/whisperx#whisperx-alignment` to a HypiHub Endpoint in the same Profile. It uses the same-`hypihub.oauth` credential and defaults to `victor-upmeet/whisperx`. Keep-`@hypit/provider-whisperx-local` only as an explicitly selected fallback; do not add it to the default-Skill-created Profile.+`hypihub.oauth` credential and defaults to `victor-upmeet/whisperx`. The Skill-created Profile must+bind this capability to HypiHub.An Author Source importing `@hypit/gemini` remains Provider-neutral. Bind those capabilities to`@hypit/provider-hypihub` for HypiHub's upload-backed Gemini endpoint, or to@@ -72,8 +71,7 @@ Provider-specific input limits are also part of preflight. For the KIE GPT Imagesubmit `4:3`, `3:4` or `4:5`; the route rejects those aspect ratios before upload or paid submission.The local Providers stay small: `media` and `hyperframes` are bounded by this machine's cores rather-than by a remote queue. WhisperX alignment uses the HypiHub lane in the default Skill path; the local-WhisperX Provider remains available only when an author explicitly selects it.+than by a remote queue. WhisperX alignment uses the HypiHub lane in the Skill path.Set this while writing the Profile. Changing it later needs a Worker restart, and the restart rulebelow makes that costly once a Build is in flight.