README.md

metadata

title: HyperView
emoji: 🔮
colorFrom: purple
colorTo: blue
sdk: docker
app_port: 7860
pinned: false

HyperView Hello World

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
• Hyper3-CLIP (hyper3-clip-v1) 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 is the broad supercategory, while sample metadata keeps common name, species, kingdom, phylum, class, order, family, genus, location fields, license, and rights holder.

The Docker image installs released packages from PyPI:

• hyperview==1.1.1
• hyper-models[ml]==0.3.2

Dataset

The default stratified sample contains 300 images:

Label	Samples
plants	50
insects	50
birds	42
arachnids	36
amphibians	30
reptiles	26
fungi	26
mammals	20
fish	10
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.

Reuse This Template

When copying this folder for another dataset:

1. Edit the constants block at the top of demo.py.
2. Update the stratification labels and target counts.
3. Rename the copied Space from HyperView to your project name.
4. Point a deploy workflow at the new folder.

Deploy Source

This folder is synchronized to hyper3labs/HyperView by GitHub Actions from the hyperview-spaces deployment repository.

Because hyper3-clip-v1 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.