Roll back to 65656a0 content (hycoclip demo): Hyper3-CLIP deploy failed on gated model download, no HF_TOKEN runtime secret

.hyperview/extensions/hello-world-intro/extension.toml

@@ -1,8 +0,0 @@
-name = "hello-world-intro"
-description = "Short orientation panel for the HyperView Hello World workspace"
-
-[[panels]]
-id = "hello-world-intro"
-title = "Start here"
-position = "right"
-file = "panel.jsx"

.hyperview/extensions/hello-world-intro/panel.jsx

@@ -1,80 +0,0 @@
-const sdk = globalThis.HyperViewPanelSDK;
-if (!sdk || sdk.version !== "2") {
-  throw new Error("HyperViewPanelSDK v2 is not available on window.");
-}
-
-const { React, components, hooks } = sdk;
-const { Panel } = components;
-const { usePanelState, useSelection } = hooks;
-
-const geometryColors = {
-  Euclidean: "#67e8f9",
-  Spherical: "#a78bfa",
-  "Hyperbolic · Poincare": "#fb923c",
-};
-
-export default function HelloWorldIntro() {
-  const { props } = usePanelState();
-  const { selectedIds } = useSelection();
-  const geometries = Array.isArray(props.geometries) ? props.geometries : [];
-
-  return (
-    <Panel>
-      <div className="hello-world-intro">
-        <span className="hello-world-kicker">HyperView Hello World</span>
-        <h2>One image collection.<br />Three geometries.</h2>
-        <p className="hello-world-lede">
-          Every map contains the same {props.sampleCount || 300} {props.dataset || "iNaturalist"} observations.
-          What changes is the representation and the geometry used to lay it out.
-        </p>
-
-        <div className="hello-world-geometry-list">
-          {geometries.map((geometry) => (
-            <article key={geometry.name}>
-              <i style={{ background: geometryColors[geometry.name] || "#94a3b8" }} />
-              <span>
-                <strong>{geometry.name}</strong>
-                <small>{geometry.model} · {geometry.dimension}</small>
-              </span>
-            </article>
-          ))}
-        </div>
-
-        <div className="hello-world-steps">
-          <strong>Try this</strong>
-          <ol>
-            <li>Rotate and zoom each map.</li>
-            <li>Select a cluster in one view.</li>
-            <li>Compare where that selection lands in the other geometries.</li>
-            <li>Open Samples to inspect the underlying observations.</li>
-          </ol>
-        </div>
-
-        <div className={`hello-world-selection${selectedIds.length ? " is-active" : ""}`}>
-          <span>{selectedIds.length ? selectedIds.length : "No"}</span>
-          {selectedIds.length === 1 ? " observation selected" : " observations selected"}
-        </div>
-      </div>
-
-      <style>{`
-        .hello-world-intro { height: 100%; overflow: auto; padding: 22px; color: var(--hv-color-foreground); background: radial-gradient(circle at 90% 0%, color-mix(in srgb, var(--hv-color-accent) 12%, transparent), transparent 32%); }
-        .hello-world-kicker { color: var(--hv-color-accent); font: 600 10px/1.2 ui-monospace, SFMono-Regular, Menlo, monospace; letter-spacing: .16em; text-transform: uppercase; }
-        .hello-world-intro h2 { margin: 12px 0 10px; font: 650 27px/1.08 system-ui, sans-serif; letter-spacing: -.035em; }
-        .hello-world-lede { margin: 0; color: var(--hv-color-muted-foreground); font: 13px/1.55 system-ui, sans-serif; }
-        .hello-world-geometry-list { display: grid; gap: 8px; margin: 20px 0; }
-        .hello-world-geometry-list article { display: flex; align-items: center; gap: 11px; padding: 11px 12px; border: 1px solid var(--hv-color-border); border-radius: 10px; background: color-mix(in srgb, var(--hv-color-surface) 86%, transparent); }
-        .hello-world-geometry-list i { width: 8px; height: 30px; border-radius: 999px; }
-        .hello-world-geometry-list span { display: grid; gap: 2px; }
-        .hello-world-geometry-list strong { font: 600 12px/1.2 system-ui, sans-serif; }
-        .hello-world-geometry-list small { color: var(--hv-color-muted-foreground); font: 10px/1.2 ui-monospace, SFMono-Regular, Menlo, monospace; }
-        .hello-world-steps { padding: 14px; border: 1px solid var(--hv-color-border); border-radius: 12px; background: var(--hv-color-surface-muted); font: 12px/1.5 system-ui, sans-serif; }
-        .hello-world-steps > strong { font-size: 11px; letter-spacing: .08em; text-transform: uppercase; }
-        .hello-world-steps ol { margin: 9px 0 0; padding-left: 19px; color: var(--hv-color-muted-foreground); }
-        .hello-world-steps li + li { margin-top: 5px; }
-        .hello-world-selection { display: flex; align-items: baseline; gap: 6px; margin-top: 14px; color: var(--hv-color-muted-foreground); font: 11px/1.2 ui-monospace, SFMono-Regular, Menlo, monospace; }
-        .hello-world-selection span { color: var(--hv-color-foreground); font-size: 18px; font-weight: 650; }
-        .hello-world-selection.is-active span { color: var(--hv-color-accent); }
-      `}</style>
-    </Panel>
-  );
-}

Dockerfile

@@ -21,7 +21,7 @@ WORKDIR $HOME/app
 
 RUN pip install --upgrade pip
 
-ARG HYPERVIEW_VERSION=1.1.1
+ARG HYPERVIEW_VERSION=1.0.0
 ARG HYPER_MODELS_VERSION=0.3.1
 
 # Install CPU-only PyTorch first so the Space does not pull the default CUDA bundle,
@@ -31,11 +31,12 @@ RUN pip install "hyperview==${HYPERVIEW_VERSION}" && python -c "import hyperview
 RUN pip install "hyper-models[ml]==${HYPER_MODELS_VERSION}" && python -c "import hyper_models; print('hyper_models', hyper_models.__version__)"
 
 COPY --chown=user demo.py ./demo.py
-COPY --chown=user .hyperview ./.hyperview
 
-# Only POST/PATCH/DELETE under /api/ are token-gated -- media GETs stay open
-# either way. This marks the server public so viewer commands run without the
-# token, while provider.register, extension.install, tools and compute get 403.
+# HyperView 1.0 mints a session token and rejects unauthenticated runtime
+# commands. A public Space has no way to hand visitors that token, so panel
+# creation and case switching 401 without this. It marks the server public:
+# visitors get the viewer commands and nothing else, so provider registration,
+# extension install, tool execution and compute stay closed.
 ENV HYPERVIEW_NO_AUTH=1
 ENV HYPERVIEW_DATASETS_DIR=/home/user/app/demo_data/datasets \
     HYPERVIEW_MEDIA_DIR=/home/user/app/demo_data/media

README.md

@@ -8,15 +8,14 @@ app_port: 7860
 pinned: false
 ---
 
-# HyperView Hello World
+# HyperView - iNat24 Tiny Geometry Showcase
 
-This is the main HyperView starter Space. It shows the same higher-resolution,
-taxonomy-backed image sample through three geometric views and includes a small
-custom introduction panel built with the public HyperView panel SDK:
+This is the main HyperView demo Space. It shows the same taxonomy-backed image
+sample through multiple geometric views:
 
 - CLIP (`openai/clip-vit-base-patch32`) in Euclidean 3D
 - CLIP (`openai/clip-vit-base-patch32`) in spherical 3D
-- Hyper3-CLIP (`hyper3-clip-v0.5`) in hyperbolic Poincare 2D
+- HyCoCLIP (`hycoclip-vit-s`) in Poincare 2D
 
 The sample is drawn from `evendrow/inat24_tiny`, a compact iNaturalist 2024
 subset with 1,000 images, 100 species, and taxonomy metadata. The visible label
@@ -26,7 +25,7 @@ rights holder.
 
 The Docker image installs released packages from PyPI:
 
-- `hyperview==1.1.1`
+- `hyperview==1.0.0`
 - `hyper-models[ml]==0.3.1`
 
 ## Dataset
@@ -47,8 +46,7 @@ The default stratified sample contains 300 images:
 | mollusks | 10 |
 
 This keeps the demo small enough for Hugging Face CPU Spaces while preserving a
-real biological hierarchy for geometry comparison. Images are resized only
-when they exceed 1024 × 1024, avoiding the tiny 32 × 32 appearance of CIFAR.
+real biological hierarchy for geometry comparison.
 
 ## Reuse This Template
 
@@ -63,7 +61,3 @@ When copying this folder for another dataset:
 
 This folder is synchronized to `hyper3labs/HyperView` by GitHub Actions from
 the `hyperview-spaces` deployment repository.
-
-Because `hyper3-clip-v0.5` is gated on Hugging Face, the running Space needs an
-`HF_TOKEN` Space secret with read access to the model. The GitHub deployment
-credential does not become a runtime secret automatically.

demo.py

@@ -1,11 +1,10 @@
 #!/usr/bin/env python
-"""HyperView Hello World: one dataset, three embedding geometries."""
+"""HyperView main Hugging Face Space geometry demo."""
 
 from __future__ import annotations
 
 import os
 import re
-import sys
 from collections import Counter
 from pathlib import Path
 
@@ -17,15 +16,7 @@ import hyperview as hv
 SPACE_HOST = "0.0.0.0"
 SPACE_PORT = 7860
 
-# Build the workspace and exit instead of serving it. This is how a Static
-# Space is produced: build, exit, export.
-BUILD_ONLY = os.environ.get("HYPERVIEW_BUILD_ONLY", "").lower() in {
-    "1",
-    "true",
-    "yes",
-} or "--build-only" in sys.argv[1:]
-
-DATASET_NAME = "hello_world_inat24_multigeometry"
+DATASET_NAME = "inat24_tiny_geometry_showcase"
 HF_DATASET = "evendrow/inat24_tiny"
 HF_SPLIT = "train"
 SAMPLE_SEED = 42
@@ -43,21 +34,20 @@ TARGET_SUPERCATEGORY_COUNTS = {
     "mollusks": 10,
 }
 SAMPLE_COUNT = sum(TARGET_SUPERCATEGORY_COUNTS.values())
-IMAGE_MAX_SIZE = (1024, 1024)
-INTRO_EXTENSION = Path(__file__).parent / ".hyperview" / "extensions" / "hello-world-intro"
+IMAGE_MAX_SIZE = (768, 768)
 
 EMBEDDING_LAYOUTS = [
     {
         "name": "CLIP",
         "provider": "embed-anything",
         "model": "openai/clip-vit-base-patch32",
-        "layouts": ["euclidean:3d", "spherical:3d"],
+        "layouts": ["euclidean:3d", "spherical"],
     },
     {
-        "name": "Hyper3-CLIP",
+        "name": "HyCoCLIP",
         "provider": "hyper-models",
-        "model": "hyper3-clip-v0.5",
-        "layouts": ["poincare:2d"],
+        "model": "hycoclip-vit-s",
+        "layouts": ["poincare"],
     },
 ]
 
@@ -114,7 +104,7 @@ def save_image(row: dict, destination: Path) -> None:
 
     image = ImageOps.exif_transpose(image).convert("RGB")
     image.thumbnail(IMAGE_MAX_SIZE, Image.Resampling.LANCZOS)
-    image.save(destination, format="JPEG", quality=92, optimize=True)
+    image.save(destination, format="JPEG", quality=90, optimize=True)
 
 
 def existing_label_counts(dataset: hv.Dataset) -> Counter[str]:
@@ -219,16 +209,6 @@ def build_dataset() -> tuple[hv.Dataset, dict[str, str]]:
     return dataset, layout_keys
 
 
-def geometry_title(name: str, layout: str) -> str:
-    geometry, _, dimension = layout.partition(":")
-    geometry_name = {
-        "euclidean": "Euclidean",
-        "spherical": "Spherical",
-        "poincare": "Hyperbolic · Poincare",
-    }.get(geometry, geometry.title())
-    return f"{name} · {geometry_name}{f' {dimension.upper()}' if dimension else ''}"
-
-
 def build_demo_view(layout_keys: dict[str, str]) -> hv.ui.View:
     """Open the showcase on its three geometries, side by side.
 
@@ -237,13 +217,13 @@ def build_demo_view(layout_keys: dict[str, str]) -> hv.ui.View:
     though three layouts exist -- the one thing this demo is here to show.
     """
 
-    panels: list[hv.ui.Scatter | hv.ui.Samples | hv.ui.ExtensionPanel] = []
+    panels: list[hv.ui.Scatter | hv.ui.Samples] = []
     previous_id: str | None = None
     for label, layout_key in layout_keys.items():
         name, layout = label.split(":", 1)
         panel = hv.ui.Scatter(
             id=f"map-{layout.replace(':', '-')}",
-            title=geometry_title(name, layout),
+            title=f"{name} · {layout}",
             layout_key=layout_key,
             position="center",
             reference_panel_id=previous_id,
@@ -261,47 +241,19 @@ def build_demo_view(layout_keys: dict[str, str]) -> hv.ui.View:
             layout=hv.ui.PanelLayout(height=260, min_height=180),
         )
     )
-    intro = hv.ui.ExtensionPanel(
-        id="hello-world-intro",
-        extension="hello-world-intro",
-        panel="hello-world-intro",
-        title="Start here",
-        position="right",
-        layout=hv.ui.PanelLayout(width=360, min_width=300, max_width=440),
-        props={
-            "sampleCount": SAMPLE_COUNT,
-            "dataset": "iNat24 Tiny",
-            "geometries": [
-                {"name": "Euclidean", "model": "CLIP", "dimension": "3D"},
-                {"name": "Spherical", "model": "CLIP", "dimension": "3D"},
-                {
-                    "name": "Hyperbolic · Poincare",
-                    "model": "Hyper3-CLIP",
-                    "dimension": "2D",
-                },
-            ],
-        },
-    )
-    panels.append(intro)
-    return hv.ui.View(*panels, active_panel=intro.id)
+    return hv.ui.View(*panels, active_panel=panels[0].id)
 
 
 def main() -> None:
     dataset, layout_keys = build_dataset()
     print(f"Starting HyperView on {SPACE_HOST}:{SPACE_PORT}", flush=True)
-    session = hv.launch(
+    hv.launch(
         dataset,
         host=SPACE_HOST,
         port=SPACE_PORT,
         open_browser=False,
         view=build_demo_view(layout_keys),
-        extensions=[str(INTRO_EXTENSION)],
-        block=False,
     )
-    if BUILD_ONLY:
-        print("Workspace built; stopping before serving (build-only).", flush=True)
-        return
-    session.wait()
 
 
 if __name__ == "__main__":