Update CONTRIBUTING.md to include instructions for local development of hyper-models and modify README.md for demo link. Remove hyper-models workspace configuration from pyproject.toml.

Author: mnm-matin

CONTRIBUTING.md

@@ -14,7 +14,6 @@ Clone the repo and install dependencies:
 
 ```bash
 git clone https://github.com/Hyper3Labs/HyperView.git
-git clone https://github.com/Hyper3Labs/hyper-models
 cd HyperView
 
 # Create virtual environment and install dev dependencies
@@ -28,6 +27,32 @@ npm install
 cd ..
 ```
 
+### Optional: Co-develop `hyper-models` locally (uv workspace)
+
+By default, HyperView installs `hyper-models` from PyPI.
+
+If you want to develop HyperView and `hyper-models` side-by-side (without publishing `hyper-models`), you can tell **uv** to use a local checkout instead:
+
+1) Clone `hyper-models` next to the HyperView repo (as a sibling directory):
+
+```bash
+cd ..
+git clone https://github.com/Hyper3Labs/hyper-models
+cd HyperView
+```
+
+2) Add the following to HyperView's `pyproject.toml` (keep this change local unless the maintainers decide otherwise):
+
+```toml
+[tool.uv.workspace]
+members = ["../hyper-models"]
+
+[tool.uv.sources]
+hyper-models = { workspace = true }
+```
+
+3) Use uv's project commands (`uv run ...`, `uv sync`, etc.) so `tool.uv.sources` is respected.
+
 ## Running Locally
 
 For the best development experience, run the backend and frontend in separate terminals.

README.md

@@ -2,14 +2,14 @@
 
 > **Open-source dataset curation + embedding visualization (Euclidean + Poincaré disk)**
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Hyper3Labs/HyperView)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Hyper3Labs/HyperView) [![Open in HF Spaces](https://huggingface.co/datasets/huggingface/badges/resolve/main/open-in-hf-spaces-sm.svg)](https://huggingface.co/spaces/hyper3labs/HyperView)
 
 <p align="center">
-  <a href="https://youtu.be/XLaa8FHSQtc" target="_blank">
+  <a href="https://huggingface.co/spaces/hyper3labs/HyperView" target="_blank">
     <img src="https://raw.githubusercontent.com/Hyper3Labs/HyperView/main/assets/screenshot.png" alt="HyperView Screenshot" width="100%">
   </a>
   <br>
-  <a href="https://youtu.be/XLaa8FHSQtc" target="_blank">Watch the Demo Video</a>
+  <a href="https://huggingface.co/spaces/hyper3labs/HyperView" target="_blank">Try the live demo on HuggingFace Spaces</a>
 </p>
 
 ---
@@ -21,14 +21,19 @@
 - **HuggingFace Integration**: Load datasets directly from HuggingFace Hub
 - **Fast Embeddings**: Uses EmbedAnything for CLIP-based image embeddings
 
+## Updates
+
+- **01-02-26** — [The Geometry of Image Embeddings, Hands-on Coding Workshop](https://www.meetup.com/berlin-computer-vision-group/events/312927919/) (Berlin Computer Vision Group)
+- **17-01-26** — [The Geometry of Image Embeddings, Hands-on Coding Workshop, Part I](https://www.meetup.com/berlin-computer-vision-group/events/312636174/) (Berlin Computer Vision Group)
+
 ## Quick Start
 
 **Docs:** [docs/datasets.md](docs/datasets.md) · [docs/colab.md](docs/colab.md) · [CONTRIBUTING.md](CONTRIBUTING.md) · [TESTS.md](TESTS.md)
 
 ### Installation
 
 ```bash
-pip install hyperview
+uv pip install hyperview
 ```
 
 ### Run the Demo

pyproject.toml

@@ -98,9 +98,3 @@ ignore = ["E501"]
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
-
-[tool.uv.workspace]
-members = ["../hyper-models"]
-
-[tool.uv.sources]
-hyper-models = { workspace = true }