@hugpy/video-intelligence-ui 0.1.0

package/LICENSE

@@ -0,0 +1,41 @@
+hugpy — Source-Available License
+
+Copyright (c) 2026 putkoff (hugpy.ai). All rights reserved.
+
+Permission is granted, free of charge, to use this software ("hugpy") for
+personal and non-commercial purposes, and for time-limited commercial
+evaluation, subject to the following conditions:
+
+1. Non-commercial use means use by an individual for personal purposes, or
+   use by a non-profit or educational institution for its own internal
+   purposes. Any use by, for, or on behalf of a for-profit business or in
+   connection with revenue-generating activity is commercial use — including
+   internal business use, use in producing goods or services, and use on
+   paid engagements.
+
+2. Commercial use requires a commercial license from the copyright holder.
+   Exception: a business may evaluate the software internally for up to
+   thirty (30) days free of charge; continued use after that requires a
+   commercial license.
+
+3. Redistribution of this software, in source or binary form, modified or
+   unmodified, is not permitted without prior written permission from the
+   copyright holder. Downloading the software from an official distribution
+   channel (PyPI, npm, hugpy.ai) is not redistribution.
+
+4. Modification for personal use or internal evaluation is permitted;
+   distribution of modified versions is not.
+
+5. This notice must be retained in all copies or substantial portions of
+   the software.
+
+6. Any use outside these terms automatically terminates this license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+IN THE SOFTWARE.
+
+For commercial licensing or redistribution permission: https://hugpy.ai

package/assets/sampels/studio_movies/caverns/movie.json

@@ -0,0 +1,67 @@
+{
+  "kind": "studio_movie",
+  "drift": "still-mode splices condition each segment on ONE frame of its parent \u2014 motion is NOT carried across the splice. A joint's joint_mode='vace_extend' carries motion via VACE-extend (conditioning on the parent's trailing context_frames through the diffusers video+mask extend idiom) instead of a single still. A joint_mode='cut' is a HARD scene cut: no frame carry, the parent plays in full. With movie-level reference_images set (an identity movie) every segment renders id_lock so the subject carries across scene changes even though no pixels do \u2014 on the VACE path the references win the conditioning (an i2v branch still is accepted but unused; it governs only the parent trim).",
+  "fps": 24,
+  "width": 480,
+  "height": 480,
+  "vram_budget_gb": null,
+  "id_lock": false,
+  "reference_images": [],
+  "segments": [
+    {
+      "index": 0,
+      "segment_id": "seg_00",
+      "parent_segment_id": null,
+      "prompt": "In a subterranean cavern bathed in the harsh midday sun, a towering structure dwarfs its surroundings, casting short, sharp black shadows that dance across the cavern's walls. The cavern's natural beauty is accentuated by saturated primaries, creating an intimate and awe-inspiring mood. The shot begins with a sweeping establishing view, capturing the structure's majesty. As the camera slowly pushes in, the structure's intricate details come into focus, each element standing out against the cavern's stark, yet beautiful backdrop. The light, a hard midday sun, highlights the structure's grandeur, making it the focal point of the scene. The palette is saturated primaries, intensifying the cavern's natural colors and the structure's imposing presence. The shot starts from rest, maintaining the intimate mood as the viewer is drawn closer to the structure, experiencing its grandeur through the lens.",
+      "capability": "t2v",
+      "model_id": "wan2.1-t2v-1.3b",
+      "model_source": "movie",
+      "seed": 0,
+      "branch_frame": null,
+      "resolved_branch": null,
+      "joint_mode": "still",
+      "context_frames": 0,
+      "context_drop": 0,
+      "vram_budget_gb": 21.6,
+      "budget_source": "autofit:ae",
+      "clip_path": "/mnt/llm_storage/video_intel/studio_movies/a0a47af626bd471da3c06832f7e4f99d/segment_00/5eea7770a554fef0c3bdc38f8f38b925dcf75f13c015d423e8eadec47d41bf6b/clip.mp4",
+      "clip_uri": "/mnt/llm_storage/video_intel/studio_movies/a0a47af626bd471da3c06832f7e4f99d/segment_00/5eea7770a554fef0c3bdc38f8f38b925dcf75f13c015d423e8eadec47d41bf6b/clip.mp4",
+      "frames": 81,
+      "width": 480,
+      "height": 480,
+      "duration_s": 3.375,
+      "content_hash": "5eea7770a554fef0c3bdc38f8f38b925dcf75f13c015d423e8eadec47d41bf6b",
+      "resumed": false,
+      "status": "done"
+    },
+    {
+      "index": 1,
+      "segment_id": "seg_01",
+      "parent_segment_id": "seg_00",
+      "prompt": "In a flooded forest, a pair of exhausted hands, their skin slick with water and sweat, complete a delicate task under the unflattering, green fluorescent strip light. The cool teal and slate palette, cool and muted, highlights the hands' strained features. As the camera pulls back, revealing the hands' movements, a towering structure, bathed in harsh midday sun, casts sharp shadows across the flooded forest. The structure's intricate details stand out against the unflattering light, creating an intimate and awe-inspiring mood. The shot begins from rest, maintaining the exhausted and awe-inspiring mood as the viewer is drawn closer to the hands and the structure, experiencing their struggle and the cavern's natural beauty through the lens.",
+      "capability": "i2v",
+      "model_id": null,
+      "model_source": "capability_fallback",
+      "pinned_model_id": "wan2.1-t2v-1.3b",
+      "model_note": "movie-level pin 'wan2.1-t2v-1.3b' serves t2v, not 'i2v'; this segment resolved a capable model through the studio router instead (the pin still binds the segments it serves)",
+      "joint_mode": "still",
+      "context_frames": 0,
+      "resolved_branch": 80,
+      "vram_budget_gb": 21.6,
+      "budget_source": "autofit:ae",
+      "status": "failed",
+      "error": {
+        "code": "cancelled",
+        "message": "cancelled (render child killed after grace)"
+      }
+    }
+  ],
+  "joints": [],
+  "assembly": {
+    "movie": "movie.mp4",
+    "total_frames": 81
+  },
+  "partial": true,
+  "segments_completed": 1,
+  "segments_total": 2
+}

package/assets/sampels/studio_movies/caverns/segment_00/5eea7770a554fef0c3bdc38f8f38b925dcf75f13c015d423e8eadec47d41bf6b/manifest.json

@@ -0,0 +1,87 @@
+{
+  "adapters": [],
+  "capability": "t2v",
+  "control_image": "",
+  "control_kind": "",
+  "controls": [],
+  "determinism_class": "seeded_approx",
+  "env_snapshot": [
+    [
+      "STUDIO_ALLOW_UNPINNED",
+      "1"
+    ],
+    [
+      "STUDIO_LOUDNESS_LUFS",
+      "-14.0"
+    ],
+    [
+      "STUDIO_MANIFEST_ROOT",
+      "/mnt/llm_storage/video_intel/studio/manifests"
+    ],
+    [
+      "STUDIO_MASTER_COLORSPACE",
+      "rec709"
+    ],
+    [
+      "STUDIO_MASTER_FPS",
+      "24"
+    ],
+    [
+      "STUDIO_MAX_VRAM_GB",
+      "24.0"
+    ],
+    [
+      "STUDIO_OUTPUT_ROOT",
+      "/mnt/llm_storage/video_intel/studio_movies/a0a47af626bd471da3c06832f7e4f99d/segment_00"
+    ],
+    [
+      "STUDIO_WEIGHTS_ROOT",
+      "/mnt/llm_storage/video_intel/studio/weights"
+    ]
+  ],
+  "framework": "wan",
+  "identity_ids": [],
+  "identity_view_hashes": [],
+  "model_id": "wan2.1-t2v-1.3b",
+  "negative_prompt": "deformed hands, extra fingers, extra limbs, fused faces, warped anatomy, flicker, temporal instability, morphing, blur, low resolution, jpeg artifacts, watermark, text overlay, logo, oversaturation, banding, duplicate subject, changing wardrobe, identity drift, camera shake",
+  "precision": "fp16",
+  "prompt": "In a subterranean cavern bathed in the harsh midday sun, a towering structure dwarfs its surroundings, casting short, sharp black shadows that dance across the cavern's walls. The cavern's natural beauty is accentuated by saturated primaries, creating an intimate and awe-inspiring mood. The shot begins with a sweeping establishing view, capturing the structure's majesty. As the camera slowly pushes in, the structure's intricate details come into focus, each element standing out against the cavern's stark, yet beautiful backdrop. The light, a hard midday sun, highlights the structure's grandeur, making it the focal point of the scene. The palette is saturated primaries, intensifying the cavern's natural colors and the structure's imposing presence. The shot starts from rest, maintaining the intimate mood as the viewer is drawn closer to the structure, experiencing its grandeur through the lens.",
+  "provenance": {
+    "c2pa_pending": true,
+    "created_at": "2026-08-01T12:31:02.798001+00:00",
+    "operator": "hugpy-studio",
+    "tool": "hugpy-studio"
+  },
+  "reference_images": [],
+  "render_id": "76e36675e8a04266931c69cb49b41412",
+  "requested_frames": null,
+  "resolution_ladder": [
+    [
+      480,
+      480,
+      24
+    ]
+  ],
+  "sampler": {
+    "cfg": 5.0,
+    "sampler": "unipc",
+    "scheduler": "flow_match",
+    "shift": 3.0,
+    "sigmas": [],
+    "steps": 32
+  },
+  "seeds": {
+    "chunk_seed_base": null,
+    "global_seed": 0,
+    "stage_seeds": [
+      [
+        "base",
+        0
+      ]
+    ]
+  },
+  "source_video": "",
+  "task": "t2v",
+  "vace_context_frames": [],
+  "weight_hash": null
+}

package/assets/sampels/studio_movies/caverns/segment_00/5eea7770a554fef0c3bdc38f8f38b925dcf75f13c015d423e8eadec47d41bf6b/provenance.json

@@ -0,0 +1,7 @@
+{
+  "c2pa_pending": true,
+  "created_at": "2026-08-01T12:31:02.798001+00:00",
+  "operator": "hugpy-studio",
+  "tool": "hugpy-studio",
+  "weights_root_used": "hot"
+}

package/assets/sampels/studio_movies/keeper-matrix/_assembly/concat_list.txt

@@ -0,0 +1,2 @@
+file '/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/_assembly/contrib_00.mp4'
+file '/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/_assembly/contrib_01.mp4'

package/assets/sampels/studio_movies/keeper-matrix/movie.json

@@ -0,0 +1,81 @@
+{
+  "kind": "studio_movie",
+  "drift": "still-mode splices condition each segment on ONE frame of its parent \u2014 motion is NOT carried across the splice. A joint's joint_mode='vace_extend' carries motion via VACE-extend (conditioning on the parent's trailing context_frames through the diffusers video+mask extend idiom) instead of a single still. A joint_mode='cut' is a HARD scene cut: no frame carry, the parent plays in full. With movie-level reference_images set (an identity movie) every segment renders id_lock so the subject carries across scene changes even though no pixels do \u2014 on the VACE path the references win the conditioning (an i2v branch still is accepted but unused; it governs only the parent trim).",
+  "fps": 16,
+  "width": 832,
+  "height": 480,
+  "vram_budget_gb": null,
+  "id_lock": false,
+  "reference_images": [],
+  "segments": [
+    {
+      "index": 0,
+      "segment_id": "seg_00",
+      "parent_segment_id": null,
+      "prompt": "a small wooden sailboat on a bright blue lake, gentle waves, sunny day",
+      "capability": "t2v",
+      "model_id": "wan2.1-t2v-1.3b",
+      "model_source": "auto",
+      "seed": 0,
+      "branch_frame": null,
+      "resolved_branch": null,
+      "joint_mode": "still",
+      "context_frames": 0,
+      "context_drop": 0,
+      "vram_budget_gb": 21.6,
+      "budget_source": "autofit:ae",
+      "clip_path": "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_00/64854c6a21d47ce10b23e884e12de448b25bfb0a375d33238dd0bec8056c076d/clip.mp4",
+      "clip_uri": "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_00/64854c6a21d47ce10b23e884e12de448b25bfb0a375d33238dd0bec8056c076d/clip.mp4",
+      "frames": 81,
+      "width": 832,
+      "height": 480,
+      "duration_s": 5.0625,
+      "content_hash": "64854c6a21d47ce10b23e884e12de448b25bfb0a375d33238dd0bec8056c076d",
+      "resumed": false,
+      "status": "done"
+    },
+    {
+      "index": 1,
+      "segment_id": "seg_01",
+      "parent_segment_id": "seg_00",
+      "prompt": "the same lake at sunset, boat sailing away",
+      "capability": "i2v",
+      "model_id": "wan2.1-i2v-14b-720p",
+      "model_source": "auto",
+      "seed": 1,
+      "branch_frame": null,
+      "resolved_branch": 80,
+      "joint_mode": "still",
+      "context_frames": 0,
+      "context_drop": 0,
+      "vram_budget_gb": 21.6,
+      "budget_source": "autofit:ae",
+      "clip_path": "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_01/cc926b44a42b90d7d291a4e50e3859458306c207a17c718086a3466e4049d6c6/clip.mp4",
+      "clip_uri": "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_01/cc926b44a42b90d7d291a4e50e3859458306c207a17c718086a3466e4049d6c6/clip.mp4",
+      "frames": 81,
+      "width": 832,
+      "height": 480,
+      "duration_s": 5.0625,
+      "content_hash": "cc926b44a42b90d7d291a4e50e3859458306c207a17c718086a3466e4049d6c6",
+      "resumed": false,
+      "status": "done"
+    }
+  ],
+  "joints": [
+    {
+      "parent_segment_id": "seg_00",
+      "child_segment_id": "seg_01",
+      "branch_frame": 80,
+      "trim_frames": 81,
+      "mode": "still",
+      "context_frames": null
+    }
+  ],
+  "assembly": {
+    "movie": "movie.mp4",
+    "total_frames": 162
+  },
+  "partial": false,
+  "segments_completed": 2,
+  "segments_total": 2
+}

package/assets/sampels/studio_movies/keeper-matrix/segment_00/64854c6a21d47ce10b23e884e12de448b25bfb0a375d33238dd0bec8056c076d/manifest.json

@@ -0,0 +1,87 @@
+{
+  "adapters": [],
+  "capability": "t2v",
+  "control_image": "",
+  "control_kind": "",
+  "controls": [],
+  "determinism_class": "seeded_approx",
+  "env_snapshot": [
+    [
+      "STUDIO_ALLOW_UNPINNED",
+      "1"
+    ],
+    [
+      "STUDIO_LOUDNESS_LUFS",
+      "-14.0"
+    ],
+    [
+      "STUDIO_MANIFEST_ROOT",
+      "/mnt/llm_storage/video_intel/studio/manifests"
+    ],
+    [
+      "STUDIO_MASTER_COLORSPACE",
+      "rec709"
+    ],
+    [
+      "STUDIO_MASTER_FPS",
+      "16"
+    ],
+    [
+      "STUDIO_MAX_VRAM_GB",
+      "24.0"
+    ],
+    [
+      "STUDIO_OUTPUT_ROOT",
+      "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_00"
+    ],
+    [
+      "STUDIO_WEIGHTS_ROOT",
+      "/mnt/llm_storage/video_intel/studio/weights"
+    ]
+  ],
+  "framework": "wan",
+  "identity_ids": [],
+  "identity_view_hashes": [],
+  "model_id": "wan2.1-t2v-1.3b",
+  "negative_prompt": "",
+  "precision": "fp16",
+  "prompt": "a small wooden sailboat on a bright blue lake, gentle waves, sunny day",
+  "provenance": {
+    "c2pa_pending": true,
+    "created_at": "2026-08-01T04:39:22.027194+00:00",
+    "operator": "hugpy-studio",
+    "tool": "hugpy-studio"
+  },
+  "reference_images": [],
+  "render_id": "c3c83e4ea22d4dc5a4b384750abe8358",
+  "requested_frames": null,
+  "resolution_ladder": [
+    [
+      832,
+      480,
+      16
+    ]
+  ],
+  "sampler": {
+    "cfg": 5.0,
+    "sampler": "unipc",
+    "scheduler": "flow_match",
+    "shift": 3.0,
+    "sigmas": [],
+    "steps": 12
+  },
+  "seeds": {
+    "chunk_seed_base": null,
+    "global_seed": 0,
+    "stage_seeds": [
+      [
+        "base",
+        0
+      ]
+    ]
+  },
+  "source_video": "",
+  "task": "t2v",
+  "vace_context_frames": [],
+  "weight_hash": null
+}

package/assets/sampels/studio_movies/keeper-matrix/segment_00/64854c6a21d47ce10b23e884e12de448b25bfb0a375d33238dd0bec8056c076d/provenance.json

@@ -0,0 +1,7 @@
+{
+  "c2pa_pending": true,
+  "created_at": "2026-08-01T04:39:22.027194+00:00",
+  "operator": "hugpy-studio",
+  "tool": "hugpy-studio",
+  "weights_root_used": "hot"
+}

package/assets/sampels/studio_movies/keeper-matrix/segment_01/cc926b44a42b90d7d291a4e50e3859458306c207a17c718086a3466e4049d6c6/manifest.json

@@ -0,0 +1,87 @@
+{
+  "adapters": [],
+  "capability": "i2v",
+  "control_image": "",
+  "control_kind": "",
+  "controls": [],
+  "determinism_class": "seeded_approx",
+  "env_snapshot": [
+    [
+      "STUDIO_ALLOW_UNPINNED",
+      "1"
+    ],
+    [
+      "STUDIO_LOUDNESS_LUFS",
+      "-14.0"
+    ],
+    [
+      "STUDIO_MANIFEST_ROOT",
+      "/mnt/llm_storage/video_intel/studio/manifests"
+    ],
+    [
+      "STUDIO_MASTER_COLORSPACE",
+      "rec709"
+    ],
+    [
+      "STUDIO_MASTER_FPS",
+      "16"
+    ],
+    [
+      "STUDIO_MAX_VRAM_GB",
+      "24.0"
+    ],
+    [
+      "STUDIO_OUTPUT_ROOT",
+      "/mnt/llm_storage/video_intel/studio_movies/keeper-matrix/segment_01"
+    ],
+    [
+      "STUDIO_WEIGHTS_ROOT",
+      "/mnt/llm_storage/video_intel/studio/weights"
+    ]
+  ],
+  "framework": "wan",
+  "identity_ids": [],
+  "identity_view_hashes": [],
+  "model_id": "wan2.1-i2v-14b-720p",
+  "negative_prompt": "",
+  "precision": "fp8",
+  "prompt": "the same lake at sunset, boat sailing away",
+  "provenance": {
+    "c2pa_pending": true,
+    "created_at": "2026-08-01T04:42:21.379531+00:00",
+    "operator": "hugpy-studio",
+    "tool": "hugpy-studio"
+  },
+  "reference_images": [],
+  "render_id": "4718134b906a42a793e37f87af7475f0",
+  "requested_frames": null,
+  "resolution_ladder": [
+    [
+      832,
+      480,
+      16
+    ]
+  ],
+  "sampler": {
+    "cfg": 5.0,
+    "sampler": "unipc",
+    "scheduler": "flow_match",
+    "shift": 3.0,
+    "sigmas": [],
+    "steps": 12
+  },
+  "seeds": {
+    "chunk_seed_base": null,
+    "global_seed": 1,
+    "stage_seeds": [
+      [
+        "base",
+        1
+      ]
+    ]
+  },
+  "source_video": "",
+  "task": "i2v",
+  "vace_context_frames": [],
+  "weight_hash": null
+}

package/assets/sampels/studio_movies/keeper-matrix/segment_01/cc926b44a42b90d7d291a4e50e3859458306c207a17c718086a3466e4049d6c6/provenance.json

@@ -0,0 +1,7 @@
+{
+  "c2pa_pending": true,
+  "created_at": "2026-08-01T04:42:21.379531+00:00",
+  "operator": "hugpy-studio",
+  "tool": "hugpy-studio",
+  "weights_root_used": "hot"
+}

package/entry.tsx

@@ -0,0 +1,74 @@
+// Standalone bootstrap for the video-intelligence arm. The dev UI links to
+// /video; this mounts the station shell there. A BrowserRouter (basename from
+// the Vite base) is provided because stations are routed tabs.
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { BrowserRouter } from "react-router-dom";
+import { StationShell } from "./src/stations/StationShell";
+import { hugpyConfig } from "./src/config";
+import { startSessionMetering } from "./src/session";
+import { initShare } from "./src/share";
+import { installVideoDemo } from "./src/demo";
+// Sitewide floating Help button. ONE shared framework-free DOM module mounted
+// identically by all four surfaces (main SPA + media/video/fleet arms) — see
+// ../ui_shared/help/helpWidget.js for why it isn't a copied React component.
+import { mountHelpWidget } from "../ui_shared/help/helpWidget";
+import "./src/style/app.css";
+
+// k9: lift a `?share=<key>` share-link credential out of the URL (stash + strip)
+// BEFORE any API call, so the very first fetch already carries it. No-op for a
+// normal console session (no key present).
+initShare();
+
+// Canned demo (?demo=1): install the fetch shim + seed the library BEFORE
+// anything below can touch the network. No-op outside demo mode.
+installVideoDemo();
+
+// Per-session upload lifecycle: heartbeat the server so it keeps this session's
+// uploads, and beacon a wipe on tab close. (No-op in canned demo mode.)
+startSessionMetering();
+
+// Contract guard: this arm depends ENTIRELY on the current hugpy API, whose
+// /version reports an integer `api` contract version. Fire-and-forget on boot —
+// never block or delay rendering, and swallow any fetch/parse error.
+const EXPECTED_API_CONTRACT = 1;
+void (async () => {
+  try {
+    const res = await fetch(`${hugpyConfig.apiBase}/version`, {
+      credentials: hugpyConfig.withCredentials ? "include" : "same-origin",
+    });
+    if (!res.ok) return;
+    const body = (await res.json()) as { api?: unknown };
+    const api = body?.api;
+    if (api !== EXPECTED_API_CONTRACT) {
+      console.warn(
+        `hugpy API contract mismatch (got ${String(api)}, expected ${EXPECTED_API_CONTRACT})`,
+      );
+    }
+  } catch {
+    // swallow: never let the contract check disrupt boot.
+  }
+})();
+
+const el = document.getElementById("root");
+if (!el) throw new Error("video-intelligence: #root not found");
+
+// Router basename must match where the bundle is SERVED, which equals the Vite
+// build base: "/video/" for the in-hugpy build, "/" for a standalone deploy.
+// A mismatched basename makes React-Router render nothing → blank screen.
+const basename = import.meta.env.BASE_URL.replace(/\/$/, "") || "/";
+
+// Mounted outside the React tree (its own fixed-position node on <body>), so it
+// is unaffected by station routing and by the arm's Tailwind layout.
+mountHelpWidget({ apiBase: hugpyConfig.apiBase, surface: "studio" });
+
+createRoot(el).render(
+  <React.StrictMode>
+    <BrowserRouter basename={basename}>
+      {/* The DemoBanner now lives INSIDE StationShell, directly beneath the nav
+          (operator directive 2026-07-21: nav + demo tag = one fixed header
+          stack), rather than floating above the whole shell. */}
+      <StationShell />
+    </BrowserRouter>
+  </React.StrictMode>,
+);