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
fix(distribution): ship the yt-dlp service alongside its CLI adapter
kashorin26a5f4a10113
diff --git a/package.json b/package.jsonindex 26e7d564..e1509497 100644--- a/package.json+++ b/package.json@@ -120,6 +120,10 @@"services/whisperx/uv.lock","services/whisperx/README.md","services/whisperx/src/**/*.py",+ "services/yt-dlp/pyproject.toml",+ "services/yt-dlp/package.json",+ "services/yt-dlp/uv.lock",+ "services/yt-dlp/README.md","docs/public/hypit-logo-dark.svg","docs/public/hypit-logo-light.svg","examples/minimal-author-package/README.md",diff --git a/packages/video-cli/README.md b/packages/video-cli/README.mdindex 10087836..5c013268 100644--- a/packages/video-cli/README.md+++ b/packages/video-cli/README.md@@ -99,7 +99,8 @@ Grid `samples` retain the requested times; `frames` contain the actual extractedIt also reports every page path for `tiles`. The media layer reads existing timed text; transcriptionand its Endpoint remain separate. `boundaries` reports adjacent-framechange candidates and their measured scores; it does not suppress short changes or call them shots.-`fetch` turns a link into a file with the pinned yt-dlp. Commands that create evidence write only+`fetch` turns a link into a file with the pinned yt-dlp; [the downloader package](../yt-dlp/README.md)+owns its dependencies, download choices and file handling. Commands that create evidence write onlywhat `--to` names and refuse to overwrite. `vocabulary` reads the installedmanifests: every package with its tags and models, or one package's Surfaces with their attributes,children and example, or the value shapes a drawing Producer must emit.diff --git a/packages/yt-dlp/README.md b/packages/yt-dlp/README.mdnew file mode 100644index 00000000..964f759d--- /dev/null+++ b/packages/yt-dlp/README.md@@ -0,0 +1,31 @@+# Fetching video with yt-dlp++`@hypit/yt-dlp` owns video download for the Hypit Distribution. Video CLI exposes it as:++```bash+hypit media fetch "https://example.com/watch?v=VIDEO_ID" --to references/source.mp4+```++The CLI creates destination directories, refuses existing output paths and probes the completed+file. Add `--json` for the source URL, saved path and media properties. This operation opens no+Runtime Profile and creates no Build.++## Package boundary++- `isVideoUrl(value)` recognizes HTTP and HTTPS links. Local paths, including Windows drive paths,+ remain file inputs.+- `downloadVideo(url, target)` downloads one video to the given path. Its caller owns destination+ preparation and overwrite policy. The target extension must be `.mp4`, `.mkv`, `.webm` or `.mov`.++The downloader invokes the locked Python project in `services/yt-dlp` through `uv`, located relative+to the installed Distribution. Ship its `pyproject.toml` and `uv.lock` with this package's source.+`uv` and `ffmpeg` must be available on PATH; the CLI also uses `ffprobe` to report the saved media.++The request selects `bv*+ba/b`, with `res:1080,vcodec:h264` format preferences and `--no-playlist`.+Available source streams determine the result. It stages the download in the OS temporary directory,+then moves the completed file to the target, copying on a cross-volume `EXDEV` error. Temporary+files are removed when the operation ends. Download errors retain the tool's diagnostic output.++The package supplies download behavior; the CLI owns command arguments and reporting. Production+use is described in the Hypit Skill's **Downloading a video from a link** page. The installed+`services/yt-dlp/README.md` covers direct invocation when a source needs additional yt-dlp options.diff --git a/services/yt-dlp/README.md b/services/yt-dlp/README.mdindex 18ad142e..01508923 100644--- a/services/yt-dlp/README.md+++ b/services/yt-dlp/README.md@@ -1,17 +1,19 @@# Pinned yt-dlp-A reconstruction starts from a video, and most of the videos worth reconstructing are at a link-rather than in a folder. This project holds the one dependency that turns one into a file.--The version is pinned and locked. `yt-dlp` releases constantly, because it is chasing sites that keep-changing, and an unpinned copy means two machines fetch the same link differently — which makes a-reconstruction unreproducible for a reason that has nothing to do with the video.+This project holds the locked Python downloader used by `hypit media fetch`. `uv` installs the+selected version and its dependencies when invoked. Site support follows that version's extractors;+the downloaded file preserves the source used by the production.It is invoked one command at a time rather than run as a service:```bash-uv run --project services/yt-dlp --frozen yt-dlp --version+uv run --project "/path/to/hypit/services/yt-dlp" --frozen yt-dlp --version+uv run --project "/path/to/hypit/services/yt-dlp" --frozen yt-dlp --help```-`packages/yt-dlp` is the Node side that calls it, decides whether a reference is a link at all, and-caches what it fetched.+Replace the project path with this directory in the installed Hypit Distribution. Direct invocation+accepts yt-dlp's own options, including source-specific format or authentication settings. Choose+those for the actual download. `ffmpeg` on PATH merges separate video and audio streams.++`packages/yt-dlp` is the Node wrapper used by Video CLI. It stages a download and saves the requested+project file; later commands read that file.