Deploy hyper3labs/HyperView from Hyper3Labs/hyperview-spaces@355e826

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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,80 @@
+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.0.0
+ARG HYPERVIEW_VERSION=1.1.1
 ARG HYPER_MODELS_VERSION=0.3.1
 
 # Install CPU-only PyTorch first so the Space does not pull the default CUDA bundle,
@@ -31,12 +31,11 @@ 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
 
-# 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.
+# 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.
 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,14 +8,15 @@ app_port: 7860
 pinned: false
 ---
 
-# HyperView - iNat24 Tiny Geometry Showcase
+# HyperView Hello World
 
-This is the main HyperView demo Space. It shows the same taxonomy-backed image
-sample through multiple geometric views:
+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:
 
 - CLIP (`openai/clip-vit-base-patch32`) in Euclidean 3D
 - CLIP (`openai/clip-vit-base-patch32`) in spherical 3D
-- HyCoCLIP (`hycoclip-vit-s`) in Poincare 2D
+- Hyper3-CLIP (`hyper3-clip-v0.5`) in hyperbolic 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
@@ -25,7 +26,7 @@ rights holder.
 
 The Docker image installs released packages from PyPI:
 
-- `hyperview==1.0.0`
+- `hyperview==1.1.1`
 - `hyper-models[ml]==0.3.1`
 
 ## Dataset
@@ -46,7 +47,8 @@ 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.
+real biological hierarchy for geometry comparison. Images are resized only
+when they exceed 1024 × 1024, avoiding the tiny 32 × 32 appearance of CIFAR.
 
 ## Reuse This Template
 
@@ -61,3 +63,7 @@ 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,10 +1,11 @@
 #!/usr/bin/env python
-"""HyperView main Hugging Face Space geometry demo."""
+"""HyperView Hello World: one dataset, three embedding geometries."""
 
 from __future__ import annotations
 
 import os
 import re
+import sys
 from collections import Counter
 from pathlib import Path
 
@@ -16,7 +17,15 @@ import hyperview as hv
 SPACE_HOST = "0.0.0.0"
 SPACE_PORT = 7860
 
-DATASET_NAME = "inat24_tiny_geometry_showcase"
+# 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"
 HF_DATASET = "evendrow/inat24_tiny"
 HF_SPLIT = "train"
 SAMPLE_SEED = 42
@@ -34,20 +43,21 @@ TARGET_SUPERCATEGORY_COUNTS = {
     "mollusks": 10,
 }
 SAMPLE_COUNT = sum(TARGET_SUPERCATEGORY_COUNTS.values())
-IMAGE_MAX_SIZE = (768, 768)
+IMAGE_MAX_SIZE = (1024, 1024)
+INTRO_EXTENSION = Path(__file__).parent / ".hyperview" / "extensions" / "hello-world-intro"
 
 EMBEDDING_LAYOUTS = [
     {
         "name": "CLIP",
         "provider": "embed-anything",
         "model": "openai/clip-vit-base-patch32",
-        "layouts": ["euclidean:3d", "spherical"],
+        "layouts": ["euclidean:3d", "spherical:3d"],
     },
     {
-        "name": "HyCoCLIP",
+        "name": "Hyper3-CLIP",
         "provider": "hyper-models",
-        "model": "hycoclip-vit-s",
-        "layouts": ["poincare"],
+        "model": "hyper3-clip-v0.5",
+        "layouts": ["poincare:2d"],
     },
 ]
 
@@ -104,7 +114,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=90, optimize=True)
+    image.save(destination, format="JPEG", quality=92, optimize=True)
 
 
 def existing_label_counts(dataset: hv.Dataset) -> Counter[str]:
@@ -209,6 +219,16 @@ 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.
 
@@ -217,13 +237,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] = []
+    panels: list[hv.ui.Scatter | hv.ui.Samples | hv.ui.ExtensionPanel] = []
     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=f"{name} · {layout}",
+            title=geometry_title(name, layout),
             layout_key=layout_key,
             position="center",
             reference_panel_id=previous_id,
@@ -241,19 +261,47 @@ def build_demo_view(layout_keys: dict[str, str]) -> hv.ui.View:
             layout=hv.ui.PanelLayout(height=260, min_height=180),
         )
     )
-    return hv.ui.View(*panels, active_panel=panels[0].id)
+    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)
 
 
 def main() -> None:
     dataset, layout_keys = build_dataset()
     print(f"Starting HyperView on {SPACE_HOST}:{SPACE_PORT}", flush=True)
-    hv.launch(
+    session = 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__":