Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

fix(distribution): ship the yt-dlp service alongside its CLI adapter

kashorin26a5f4a10113
diff --git a/package.json b/package.json
index 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.md
index 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 extracted
It also reports every page path for `tiles`. The media layer reads existing timed text; transcription
and its Endpoint remain separate. `boundaries` reports adjacent-frame
change 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 only
what `--to` names and refuse to overwrite. `vocabulary` reads the installed
manifests: 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.md
new file mode 100644
index 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.md
index 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.