README.md

metadata

title: HyperView Visual Safety
emoji: 🛡️
colorFrom: yellow
colorTo: gray
sdk: docker
app_port: 7860
pinned: false

HyperView - Open Images Visual Safety Demo

This demo shows a marketplace-style visual moderation workflow without showing explicit NSFW material.

It loads a small curated Open Images V7 validation subset from the Space assets and builds the HyperView dataset at startup with two buckets:

• Safe: ordinary marketplace/public-image objects such as clothing, shoes, furniture, toys, books, fruit, laptops, and mobile phones.
• Needs review: public-displayable but policy-relevant objects such as alcohol, cigarettes, knives, and firearms-related labels.

HyperView computes embeddings and opens two pinned maps at startup:

• CLIP ViT-B/32 in a Euclidean 2D layout
• hyper3-clip hyper3-clip-v0.5 from hyper-models in a Poincare 2D layout

The right-hand panel includes the measured 120-image zero-shot smoke test: CLIP is stronger overall on this first proxy, while hyper3-clip catches slightly more review-class items at the cost of more false positives.

Run locally from the HyperView repo:

uv run python hyperview-spaces/spaces/visual-safety-content-clip-hyper3clip/demo.py

Useful overrides:

HYPERVIEW_PORT=6265 SAFETY_SAMPLES_PER_BUCKET=40 \
  uv run python hyperview-spaces/spaces/visual-safety-content-clip-hyper3clip/demo.py

Dataset And Rights

The demo uses a checked-in public Open Images V7 validation subset under demo_assets/:

• Dataset: https://storage.googleapis.com/openimages/web/index.html
• Images are loaded through Hugging Face Hub asset resolution when the Space runs on Hugging Face.
• Individual source licenses are preserved in sample metadata.

This is a public demo proxy for marketplace moderation triage, not a claim that either model is a production safety classifier.

Deploy Source

This folder is intended to deploy to mnm-matin/HyperView-Visual-Safety from the hyperview-spaces deployment repository. The org Space hyper3labs/HyperView-Visual-Safety is kept commit-synced but paused.

hyper3-clip weights are loaded through the hyper-models catalog entry for the gated hyper3labs/hyper3-clip-v0.5 model repository at runtime. The Space needs an HF_TOKEN secret with access to that model.

If that secret is missing, the Space starts in a clearly labeled fallback mode: the hyper3-clip panel reuses the CLIP layout and the readout shows a runtime warning. Set HYPERVIEW_ALLOW_CANDIDATE_FALLBACK=0 to make missing hyper3-clip access fail loudly instead.