anywidget-vector 0.2.3__tar.gz → 0.2.5__tar.gz

{anywidget_vector-0.2.3 → anywidget_vector-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anywidget-vector
-Version: 0.2.3
+Version: 0.2.5
 Summary: Interactive 3D vector visualization with query UI for vector databases
 Project-URL: Homepage, https://grafeo.dev/
 Project-URL: Repository, https://github.com/GrafeoDB/anywidget-vector
@@ -24,22 +24,22 @@ Provides-Extra: all
 Requires-Dist: chromadb>=1.5; extra == 'all'
 Requires-Dist: lancedb>=0.29.2; extra == 'all'
 Requires-Dist: numpy>=2.4; extra == 'all'
-Requires-Dist: pandas>=3.0; extra == 'all'
+Requires-Dist: pandas>=3; extra == 'all'
 Requires-Dist: pinecone-client>=6.0; extra == 'all'
-Requires-Dist: qdrant-client>=1.0; extra == 'all'
-Requires-Dist: weaviate-client>=4.0; extra == 'all'
+Requires-Dist: qdrant-client>=1; extra == 'all'
+Requires-Dist: weaviate-client>=4.20; extra == 'all'
 Provides-Extra: chroma
 Requires-Dist: chromadb>=0.4; extra == 'chroma'
 Provides-Extra: demo
 Provides-Extra: dev
-Requires-Dist: marimo>=0.19.9; extra == 'dev'
+Requires-Dist: marimo>=0.20; extra == 'dev'
 Requires-Dist: prek>=0.3.2; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
-Requires-Dist: ruff>=0.15.0; extra == 'dev'
-Requires-Dist: ty>=0.0.16; extra == 'dev'
+Requires-Dist: ruff>=0.15; extra == 'dev'
+Requires-Dist: ty>=0.0.20; extra == 'dev'
 Provides-Extra: embed
 Provides-Extra: grafeo
-Requires-Dist: grafeo>=0.5.0; extra == 'grafeo'
+Requires-Dist: grafeo>=0.5; extra == 'grafeo'
 Provides-Extra: lancedb
 Requires-Dist: lancedb>=0.1; extra == 'lancedb'
 Provides-Extra: numpy
@@ -64,8 +64,8 @@ Works with Marimo, Jupyter, VS Code, Colab, anywhere [anywidget](https://anywidg
 
 - **Universal**: One widget, every notebook environment
 - **6D Visualization**: X, Y, Z position + Color, Shape, Size encoding
-- **Backend-agnostic**: NumPy, pandas, Qdrant, Chroma, or raw dicts
-- **Interactive**: Orbit, pan, zoom, click, hover, select
+- **Backend-agnostic**: NumPy, pandas, Qdrant, Chroma, Pinecone, Weaviate, LanceDB, or raw dicts
+- **Interactive**: Orbit, pan, zoom, click, hover, box select
 - **Customizable**: Color scales, shapes, sizes, themes
 - **Performant**: Instanced rendering for large point clouds
 
@@ -94,8 +94,6 @@ widget
 ### Dictionary
 
 ```python
-from anywidget_vector import VectorSpace
-
 widget = VectorSpace.from_dict({
     "points": [
         {"id": "a", "x": 0, "y": 0, "z": 0},
@@ -108,7 +106,6 @@ widget = VectorSpace.from_dict({
 
 ```python
 import numpy as np
-from anywidget_vector import VectorSpace
 
 positions = np.random.randn(100, 3)
 widget = VectorSpace.from_numpy(positions)
@@ -118,7 +115,6 @@ widget = VectorSpace.from_numpy(positions)
 
 ```python
 import pandas as pd
-from anywidget_vector import VectorSpace
 
 df = pd.DataFrame({
     "x": [0.1, 0.5, 0.9],
@@ -139,9 +135,7 @@ widget = VectorSpace.from_dataframe(
 
 ```python
 import umap
-from anywidget_vector import VectorSpace
 
-# Reduce high-dimensional data to 3D
 embedding = umap.UMAP(n_components=3).fit_transform(high_dim_data)
 widget = VectorSpace.from_umap(embedding, labels=labels)
 ```
@@ -150,7 +144,6 @@ widget = VectorSpace.from_umap(embedding, labels=labels)
 
 ```python
 from qdrant_client import QdrantClient
-from anywidget_vector import VectorSpace
 
 client = QdrantClient("localhost", port=6333)
 widget = VectorSpace.from_qdrant(client, "my_collection", limit=5000)
@@ -160,13 +153,41 @@ widget = VectorSpace.from_qdrant(client, "my_collection", limit=5000)
 
 ```python
 import chromadb
-from anywidget_vector import VectorSpace
 
 client = chromadb.Client()
 collection = client.get_collection("embeddings")
 widget = VectorSpace.from_chroma(collection)
 ```
 
+### Pinecone
+
+```python
+from pinecone import Pinecone
+
+pc = Pinecone(api_key="...")
+index = pc.Index("my-index")
+widget = VectorSpace.from_pinecone(index, limit=5000)
+```
+
+### Weaviate
+
+```python
+import weaviate
+
+client = weaviate.Client("http://localhost:8080")
+widget = VectorSpace.from_weaviate(client, "Article", limit=5000)
+```
+
+### LanceDB
+
+```python
+import lancedb
+
+db = lancedb.connect("~/.lancedb")
+table = db.open_table("vectors")
+widget = VectorSpace.from_lancedb(table, limit=5000)
+```
+
 ## Visual Encoding
 
 ### 6 Dimensions
@@ -225,7 +246,6 @@ widget = VectorSpace(points=data)
 @widget.on_click
 def handle_click(point_id, point_data):
     print(f"Clicked: {point_id}")
-    print(f"Data: {point_data}")
 
 @widget.on_hover
 def handle_hover(point_id, point_data):
@@ -240,36 +260,19 @@ def handle_selection(point_ids, points_data):
 ### Selection
 
 ```python
-widget.selected_points          # Get current selection
-widget.select(["a", "b"])       # Select points
-widget.clear_selection()        # Clear
+widget.selected_points              # Current selection
+widget.select(["a", "b"])           # Select points
+widget.clear_selection()            # Clear
+widget.selection_mode = "box"       # Switch to box-select mode
 ```
 
 ### Camera
 
 ```python
-widget.camera_position          # Get position [x, y, z]
-widget.camera_target            # Get target [x, y, z]
-widget.reset_camera()           # Reset to default
-widget.focus_on(["a", "b"])     # Focus on specific points
-```
-
-## Options
-
-```python
-widget = VectorSpace(
-    points=data,
-    width=1000,
-    height=700,
-    background="#1a1a2e",         # Dark theme default
-    show_axes=True,
-    show_grid=True,
-    axis_labels={"x": "PC1", "y": "PC2", "z": "PC3"},
-    show_tooltip=True,
-    tooltip_fields=["label", "x", "y", "z", "cluster"],
-    selection_mode="click",       # "click" or "multi"
-    use_instancing=True,          # Performance: instanced rendering
-)
+widget.camera_position              # Get position [x, y, z]
+widget.camera_target                # Get target [x, y, z]
+widget.reset_camera()               # Reset to default
+widget.focus_on(["a", "b"])         # Focus on specific points
 ```
 
 ## Distance Metrics
@@ -288,7 +291,6 @@ Compute distances and visualize similarity relationships between points.
 ### Color by Distance
 
 ```python
-# Color points by distance from a reference
 widget.color_by_distance("point_a")
 widget.color_by_distance("point_a", metric="cosine")
 ```
@@ -296,21 +298,16 @@ widget.color_by_distance("point_a", metric="cosine")
 ### Find Neighbors
 
 ```python
-# Find k nearest neighbors
 neighbors = widget.find_neighbors("point_a", k=5)
 # Returns: [("point_b", 0.1), ("point_c", 0.2), ...]
 
-# Find neighbors within distance threshold
 neighbors = widget.find_neighbors("point_a", threshold=0.5)
 ```
 
 ### Show Connections
 
 ```python
-# Draw lines to k-nearest neighbors
 widget.show_neighbors("point_a", k=5)
-
-# Draw lines to all points within threshold
 widget.show_neighbors("point_a", threshold=0.3)
 
 # Manual connection settings
@@ -327,7 +324,6 @@ widget = VectorSpace(
 ### Compute Distances
 
 ```python
-# Get distances from reference to all points
 distances = widget.compute_distances("point_a")
 # Returns: {"point_b": 0.1, "point_c": 0.5, ...}
 
@@ -335,26 +331,57 @@ distances = widget.compute_distances("point_a")
 distances = widget.compute_distances(
     "point_a",
     metric="cosine",
-    vector_field="embedding"  # Use full embedding vector
+    vector_field="embedding"
 )
 ```
 
+## Options
+
+```python
+widget = VectorSpace(
+    points=data,
+    width=1000,
+    height=700,
+    background="#1a1a2e",         # Dark theme default
+    show_axes=True,
+    show_grid=True,
+    axis_labels={"x": "PC1", "y": "PC2", "z": "PC3"},
+    show_tooltip=True,
+    tooltip_fields=["label", "x", "y", "z", "cluster"],
+    selection_mode="click",       # "click", "multi", or "box"
+    use_instancing=True,          # Performance: instanced rendering
+)
+```
+
+## Backends
+
+Configure a backend for interactive querying:
+
+```python
+widget.set_backend("chroma", client=collection)
+widget.set_backend("lancedb", client=table)
+widget.set_backend("grafeo", client=db)
+```
+
 ## Export
 
 ```python
-widget.to_json()                # Export points as JSON string
+widget.to_json()                            # Points as JSON string
+widget.to_html()                            # Self-contained HTML string
+widget.to_html(title="My Vectors")          # Custom title
+widget.save_html("vectors.html")            # Write HTML to file
 ```
 
 ## Environment Support
 
 | Environment | Supported |
 |-------------|-----------|
-| Marimo | ✅ |
-| JupyterLab | ✅ |
-| Jupyter Notebook | ✅ |
-| VS Code | ✅ |
-| Google Colab | ✅ |
-| Databricks | ✅ |
+| Marimo | Yes |
+| JupyterLab | Yes |
+| Jupyter Notebook | Yes |
+| VS Code | Yes |
+| Google Colab | Yes |
+| Databricks | Yes |
 
 ## Related
 

{anywidget_vector-0.2.3 → anywidget_vector-0.2.5}/README.md

@@ -8,8 +8,8 @@ Works with Marimo, Jupyter, VS Code, Colab, anywhere [anywidget](https://anywidg
 
 - **Universal**: One widget, every notebook environment
 - **6D Visualization**: X, Y, Z position + Color, Shape, Size encoding
-- **Backend-agnostic**: NumPy, pandas, Qdrant, Chroma, or raw dicts
-- **Interactive**: Orbit, pan, zoom, click, hover, select
+- **Backend-agnostic**: NumPy, pandas, Qdrant, Chroma, Pinecone, Weaviate, LanceDB, or raw dicts
+- **Interactive**: Orbit, pan, zoom, click, hover, box select
 - **Customizable**: Color scales, shapes, sizes, themes
 - **Performant**: Instanced rendering for large point clouds
 
@@ -38,8 +38,6 @@ widget
 ### Dictionary
 
 ```python
-from anywidget_vector import VectorSpace
-
 widget = VectorSpace.from_dict({
     "points": [
         {"id": "a", "x": 0, "y": 0, "z": 0},
@@ -52,7 +50,6 @@ widget = VectorSpace.from_dict({
 
 ```python
 import numpy as np
-from anywidget_vector import VectorSpace
 
 positions = np.random.randn(100, 3)
 widget = VectorSpace.from_numpy(positions)
@@ -62,7 +59,6 @@ widget = VectorSpace.from_numpy(positions)
 
 ```python
 import pandas as pd
-from anywidget_vector import VectorSpace
 
 df = pd.DataFrame({
     "x": [0.1, 0.5, 0.9],
@@ -83,9 +79,7 @@ widget = VectorSpace.from_dataframe(
 
 ```python
 import umap
-from anywidget_vector import VectorSpace
 
-# Reduce high-dimensional data to 3D
 embedding = umap.UMAP(n_components=3).fit_transform(high_dim_data)
 widget = VectorSpace.from_umap(embedding, labels=labels)
 ```
@@ -94,7 +88,6 @@ widget = VectorSpace.from_umap(embedding, labels=labels)
 
 ```python
 from qdrant_client import QdrantClient
-from anywidget_vector import VectorSpace
 
 client = QdrantClient("localhost", port=6333)
 widget = VectorSpace.from_qdrant(client, "my_collection", limit=5000)
@@ -104,13 +97,41 @@ widget = VectorSpace.from_qdrant(client, "my_collection", limit=5000)
 
 ```python
 import chromadb
-from anywidget_vector import VectorSpace
 
 client = chromadb.Client()
 collection = client.get_collection("embeddings")
 widget = VectorSpace.from_chroma(collection)
 ```
 
+### Pinecone
+
+```python
+from pinecone import Pinecone
+
+pc = Pinecone(api_key="...")
+index = pc.Index("my-index")
+widget = VectorSpace.from_pinecone(index, limit=5000)
+```
+
+### Weaviate
+
+```python
+import weaviate
+
+client = weaviate.Client("http://localhost:8080")
+widget = VectorSpace.from_weaviate(client, "Article", limit=5000)
+```
+
+### LanceDB
+
+```python
+import lancedb
+
+db = lancedb.connect("~/.lancedb")
+table = db.open_table("vectors")
+widget = VectorSpace.from_lancedb(table, limit=5000)
+```
+
 ## Visual Encoding
 
 ### 6 Dimensions
@@ -169,7 +190,6 @@ widget = VectorSpace(points=data)
 @widget.on_click
 def handle_click(point_id, point_data):
     print(f"Clicked: {point_id}")
-    print(f"Data: {point_data}")
 
 @widget.on_hover
 def handle_hover(point_id, point_data):
@@ -184,36 +204,19 @@ def handle_selection(point_ids, points_data):
 ### Selection
 
 ```python
-widget.selected_points          # Get current selection
-widget.select(["a", "b"])       # Select points
-widget.clear_selection()        # Clear
+widget.selected_points              # Current selection
+widget.select(["a", "b"])           # Select points
+widget.clear_selection()            # Clear
+widget.selection_mode = "box"       # Switch to box-select mode
 ```
 
 ### Camera
 
 ```python
-widget.camera_position          # Get position [x, y, z]
-widget.camera_target            # Get target [x, y, z]
-widget.reset_camera()           # Reset to default
-widget.focus_on(["a", "b"])     # Focus on specific points
-```
-
-## Options
-
-```python
-widget = VectorSpace(
-    points=data,
-    width=1000,
-    height=700,
-    background="#1a1a2e",         # Dark theme default
-    show_axes=True,
-    show_grid=True,
-    axis_labels={"x": "PC1", "y": "PC2", "z": "PC3"},
-    show_tooltip=True,
-    tooltip_fields=["label", "x", "y", "z", "cluster"],
-    selection_mode="click",       # "click" or "multi"
-    use_instancing=True,          # Performance: instanced rendering
-)
+widget.camera_position              # Get position [x, y, z]
+widget.camera_target                # Get target [x, y, z]
+widget.reset_camera()               # Reset to default
+widget.focus_on(["a", "b"])         # Focus on specific points
 ```
 
 ## Distance Metrics
@@ -232,7 +235,6 @@ Compute distances and visualize similarity relationships between points.
 ### Color by Distance
 
 ```python
-# Color points by distance from a reference
 widget.color_by_distance("point_a")
 widget.color_by_distance("point_a", metric="cosine")
 ```
@@ -240,21 +242,16 @@ widget.color_by_distance("point_a", metric="cosine")
 ### Find Neighbors
 
 ```python
-# Find k nearest neighbors
 neighbors = widget.find_neighbors("point_a", k=5)
 # Returns: [("point_b", 0.1), ("point_c", 0.2), ...]
 
-# Find neighbors within distance threshold
 neighbors = widget.find_neighbors("point_a", threshold=0.5)
 ```
 
 ### Show Connections
 
 ```python
-# Draw lines to k-nearest neighbors
 widget.show_neighbors("point_a", k=5)
-
-# Draw lines to all points within threshold
 widget.show_neighbors("point_a", threshold=0.3)
 
 # Manual connection settings
@@ -271,7 +268,6 @@ widget = VectorSpace(
 ### Compute Distances
 
 ```python
-# Get distances from reference to all points
 distances = widget.compute_distances("point_a")
 # Returns: {"point_b": 0.1, "point_c": 0.5, ...}
 
@@ -279,26 +275,57 @@ distances = widget.compute_distances("point_a")
 distances = widget.compute_distances(
     "point_a",
     metric="cosine",
-    vector_field="embedding"  # Use full embedding vector
+    vector_field="embedding"
 )
 ```
 
+## Options
+
+```python
+widget = VectorSpace(
+    points=data,
+    width=1000,
+    height=700,
+    background="#1a1a2e",         # Dark theme default
+    show_axes=True,
+    show_grid=True,
+    axis_labels={"x": "PC1", "y": "PC2", "z": "PC3"},
+    show_tooltip=True,
+    tooltip_fields=["label", "x", "y", "z", "cluster"],
+    selection_mode="click",       # "click", "multi", or "box"
+    use_instancing=True,          # Performance: instanced rendering
+)
+```
+
+## Backends
+
+Configure a backend for interactive querying:
+
+```python
+widget.set_backend("chroma", client=collection)
+widget.set_backend("lancedb", client=table)
+widget.set_backend("grafeo", client=db)
+```
+
 ## Export
 
 ```python
-widget.to_json()                # Export points as JSON string
+widget.to_json()                            # Points as JSON string
+widget.to_html()                            # Self-contained HTML string
+widget.to_html(title="My Vectors")          # Custom title
+widget.save_html("vectors.html")            # Write HTML to file
 ```
 
 ## Environment Support
 
 | Environment | Supported |
 |-------------|-----------|
-| Marimo | ✅ |
-| JupyterLab | ✅ |
-| Jupyter Notebook | ✅ |
-| VS Code | ✅ |
-| Google Colab | ✅ |
-| Databricks | ✅ |
+| Marimo | Yes |
+| JupyterLab | Yes |
+| Jupyter Notebook | Yes |
+| VS Code | Yes |
+| Google Colab | Yes |
+| Databricks | Yes |
 
 ## Related
 

{anywidget_vector-0.2.3 → anywidget_vector-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anywidget-vector"
-version = "0.2.3"
+version = "0.2.5"
 description = "Interactive 3D vector visualization with query UI for vector databases"
 readme = "README.md"
 license = "Apache-2.0"
@@ -28,9 +28,9 @@ dependencies = [
 dev = [
     "prek>=0.3.2",
     "pytest>=9.0.2",
-    "ruff>=0.15.0",
-    "ty>=0.0.16",
-    "marimo>=0.19.9",
+    "ruff>=0.15",
+    "ty>=0.0.20",
+    "marimo>=0.20",
 ]
 pandas = ["pandas>=2.0"]
 numpy = ["numpy>=1.24"]
@@ -39,16 +39,16 @@ chroma = ["chromadb>=0.4"]
 pinecone = ["pinecone-client>=3.0"]
 weaviate = ["weaviate-client>=4.0"]
 lancedb = ["lancedb>=0.1"]
-grafeo = ["grafeo>=0.5.0"]
+grafeo = ["grafeo>=0.5"]
 embed = []  # Marker extra — WASM loads from CDN on demand
 demo = []  # Marker extra — enables demo mode with pre-populated dataset
 all = [
-    "pandas>=3.0",
+    "pandas>=3",
     "numpy>=2.4",
-    "qdrant-client>=1.0",
+    "qdrant-client>=1",
     "chromadb>=1.5",
     "pinecone-client>=6.0",
-    "weaviate-client>=4.0",
+    "weaviate-client>=4.20",
     "lancedb>=0.29.2",
 ]
 
@@ -93,5 +93,5 @@ repos = [
 [tool.uv]
 dev-dependencies = [
     "pytest>=9.0.2",
-    "ruff>=0.14.14",
+    "ruff>=0.15",
 ]

{anywidget_vector-0.2.3 → anywidget_vector-0.2.5}/src/anywidget_vector/__init__.py

@@ -3,4 +3,4 @@
 from anywidget_vector.widget import VectorSpace
 
 __all__ = ["VectorSpace"]
-__version__ = "0.2.3"
+__version__ = "0.2.5"

{anywidget_vector-0.2.3 → anywidget_vector-0.2.5}/src/anywidget_vector/static/icons.js

@@ -11,4 +11,9 @@ export const ICONS = {
   loader: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10" stroke-dasharray="31.4" stroke-dashoffset="10"/></svg>',
   cube: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z"/><polyline points="3.27,6.96 12,12.01 20.73,6.96"/><line x1="12" y1="22.08" x2="12" y2="12"/></svg>',
   reset: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8"/><path d="M3 3v5h5"/></svg>',
+  zoomIn: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/><line x1="11" y1="8" x2="11" y2="14"/><line x1="8" y1="11" x2="14" y2="11"/></svg>',
+  zoomOut: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/><line x1="8" y1="11" x2="14" y2="11"/></svg>',
+  zoomFit: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"/></svg>',
+  cursor: '<svg viewBox="0 0 24 24" fill="currentColor" stroke="none"><path d="M4 2l12 14h-5l-2.3 5.5L6 20.3 8.3 15H4V2z"/></svg>',
+  boxSelect: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-dasharray="3 2"><rect x="3" y="3" width="18" height="18" rx="1"/></svg>',
 };