MCPcopy Index your code
hub / github.com/Renumics/spotlight

github.com/Renumics/spotlight @v1.8.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.8.0 ↗ · + Follow
1,968 symbols 6,576 edges 569 files 630 documented · 32%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Renumics Spotlight

Spotlight helps you to identify critical data segments and model failure modes. It enables you to build and maintain reliable machine learning models by curating a high-quality datasets.

Introduction

Spotlight is built on the idea that you can only truly understand unstructured datasets if you can interactively explore them. Its core principle is to identify and fix critical data segments by leveraging data enrichments (e.g. features, embeddings, uncertainties). We are building Spotlight for cross-functional teams that want to be in control of their data and data curation processes. Currently, Spotlight supports many use cases based on image, audio, video and time series data.

Quickstart

Get started by installing Spotlight and loading your first dataset.

What you'll need

  • Python version 3.10 or higher

Install Spotlight via pip

pip install renumics-spotlight

We recommend installing Spotlight and everything you need to work on your data in a separate virtual environment

To use optional analyzers, install Spotlight with analyzers extra:

pip install renumics-spotlight[analyzers]

To use optional embeddings, install Spotlight with torch extra:

# CPU support
pip install --extra-index-url https://download.pytorch.org/whl/cpu renumics-spotlight[torch]
# Default installation
pip install renumics-spotlight[torch]
# Specific CUDA version support
pip install --extra-index-url https://download.pytorch.org/whl/cu128 renumics-spotlight[torch]

See torch installation for more details.

If you are using Spotlight with Hugging Face datasets of version 4 (current default), you'll also need to install torch extra to use audio data and have FFmpeg installed on your system. See here for more details.

Load a dataset and start exploring

import pandas as pd
from renumics import spotlight

df = pd.read_csv("https://spotlight.renumics.com/data/mnist/mnist-tiny.csv")
spotlight.show(df, dtype={"image": spotlight.Image, "embedding": spotlight.Embedding})

pd.read_csv loads a sample csv file as a pandas DataFrame.

spotlight.show opens up spotlight in the browser with the pandas dataframe ready for you to explore. The dtype argument specifies custom column types for the browser viewer.

Load a Hugging Face dataset

import datasets
from renumics import spotlight

dataset = datasets.load_dataset("olivierdehaene/xkcd", split="train")
df = dataset.to_pandas()
spotlight.show(df, dtype={"image_url": spotlight.Image})

The datasets package can be installed via pip.

Extension points exported contracts — how you extend this code

ApiResponse (Interface)
(no doc) [4 implementers]
src/client/runtime.ts
ImportMetaEnv (Interface)
(no doc)
types/env.d.ts
Scale (Interface)
(no doc)
types/chroma-js.d.ts
HTMLAttributes (Interface)
(no doc)
types/twin.d.ts
Store (Interface)
(no doc)
types/globals.d.ts
BasePalette (Interface)
(no doc)
src/palettes.ts
Edition (Interface)
(no doc)
src/application.ts
BaseDataType (Interface)
(no doc)
src/datatypes.ts

Core symbols most depended-on inside this repo

keys
called by 110
renumics/spotlight/dataset/__init__.py
get
called by 79
renumics/spotlight/backend/config.py
get
called by 57
src/services/config.ts
get_dtype
called by 53
renumics/spotlight/dataset/__init__.py
approx
called by 51
tests/integration/helpers.py
domain
called by 40
src/lenses/SpectrogramLens/MelScale.tsx
append_row
called by 39
renumics/spotlight/dataset/__init__.py
empty
called by 37
renumics/spotlight/media/mesh.py

Shape

Function 1,028
Method 473
Interface 245
Class 183
Route 39

Languages

TypeScript52%
Python48%

Modules by API surface

renumics/spotlight/dataset/__init__.py108 symbols
src/client/runtime.ts70 symbols
renumics/spotlight/dtypes/__init__.py61 symbols
renumics/spotlight/backend/exceptions.py31 symbols
src/types/dataset.ts30 symbols
renumics/spotlight/backend/websockets.py27 symbols
tests/unit/dtypes/test_conversion.py24 symbols
tests/integration/dataset/test_dataset.py23 symbols
src/datatypes.ts23 symbols
renumics/spotlight/app.py23 symbols
renumics/spotlight/media/mesh.py22 symbols
renumics/spotlight/data_store.py22 symbols

For agents

$ claude mcp add spotlight \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page