Practical overview
When it fits
Use Spotlight when your data is available through a dataframe or supported dataset and you need an interactive view for examining examples, enrichments or model-debugging information.
Who it is for
- Machine-learning teams examining data quality and model outputs
- Engineers working with unstructured datasets
- Developers who want to inspect image, audio, text, video, time-series or geometric data alongside dataframe fields
Documented uses
- Visualize unstructured records held in a dataframe.
- Use embeddings, predictions and uncertainty information to inspect patterns and identify clusters.
- Review classification examples with labels, predictions, embeddings and selected features in a debugging layout.
- Explore and communicate data issues across supported modalities.
Requirements & limits
The project is open source under the MIT license and documents installation through pip.
- The documented quickstart requires Python 3.10 or later.
- Optional analyzers and embeddings require the
analyzersandtorchpackage extras, respectively. - Hugging Face datasets version 4 audio workflows require the torch extra and FFmpeg.
- The README documents crash-report and performance collection and provides
SPOTLIGHT_OPT_OUT=trueas an opt-out for crash reporting.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Open a dataframe in Spotlight
Install Spotlight and open a dataframe for interactive exploration in a browser.
Before you start
- Python 3.10 or later
- A pandas dataframe, or a CSV that can be loaded into one
- The renumics-spotlight package installed with pip
Steps
Install the package with the command below.
pip install renumics-spotlightLoad a CSV into a pandas dataframe.
Import
spotlightfromrenumicsand callspotlight.show(df, dtype={"image": spotlight.Image})when the dataframe includes an image column.
Expected outcome
Spotlight opens in a browser with the dataframe ready to explore; the dtype argument identifies the image column for the viewer.
Guide limitations
- The documented example uses a CSV and pandas dataframe; other data-loading workflows may require their own dependencies.
- A separate virtual environment is recommended by the project.
Explore a Hugging Face audio dataset with a debugging layout
Load the documented enriched audio dataset and display it with a predefined model-debugging layout.
Before you start
- Python 3.10 or later
- Spotlight with the
torchextra - The Hugging Face
datasets[audio]package - FFmpeg when using Hugging Face datasets version 4
Steps
Install Spotlight with the documented
torchextra.Load
renumics/emodb-enrichedwith the Hugging Facedatasetspackage using theallsplit.Create a debugging layout with
spotlight.layouts.debug_classification, setting the label, prediction, embedding and feature columns shown in the documented example.Call
spotlight.show(ds, layout=layout).
Expected outcome
Spotlight opens the loaded dataset with a predefined layout for inspecting classification data.
Guide limitations
- The example depends on the named dataset and its documented columns.
- For Hugging Face datasets version 4, the README specifies FFmpeg and the torch extra for audio use.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- Renumics/spotlight · Official homepage title · retained in its source language

