Install & Compatibility
Where this runs
tested against v0.23.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 449.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 24.4s · import 0.000s · 425MB
455MB installed
● package 455MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AutoVizWidget
✓ import autovizwidget
✗ from autovizwidget import AutoVizWidget
This quickstart demonstrates how to create a pandas DataFrame and then use AutoVizWidget to automatically generate interactive visualizations for it within a Jupyter environment. The `display` function from `IPython.display` is crucial for rendering the widget.
import pandas as pd
from autovizwidget.widget import AutoVizWidget
from IPython.display import display
# Create a sample DataFrame
df = pd.DataFrame({
'numerical_col': [1, 2, 3, 4, 5],
'categorical_col': ['A', 'B', 'C', 'D', 'E'],
'float_col': [10.1, 11.2, 12.3, 13.4, 14.5]
})
# Instantiate and display the AutoVizWidget
av_widget = AutoVizWidget(df)
display(av_widget)
Debug
Known issues
breakingAlthough `autovizwidget`'s direct `pandas` dependency might allow newer versions, its parent project `sparkmagic` (specifically from version 0.20.5) pinned `pandas<2.0.0` due to incompatibilities. If used within a `sparkmagic` environment, `pandas` versions 2.0.0 and above may cause issues.fixEnsure `pandas` version is less than 2.0.0 if using `autovizwidget` in conjunction with `sparkmagic` versions before 0.23.0. For `autovizwidget` 0.23.0, compatibility with `IPython 8/9` was fixed, but the `pandas` pin from `sparkmagic` might still be relevant depending on your overall environment.
affects: <0.20.5 (for sparkmagic compatibility)
gotchaOlder versions of `autovizwidget` (prior to 0.23.0) had known compatibility issues with `IPython` versions 8 and 9, leading to display problems.fixUpgrade to `autovizwidget` version 0.23.0 or newer to ensure proper functionality with `IPython` 8 and 9.
affects: <0.23.0
gotcha`AutoVizWidget` is developed as part of the `jupyter-incubator/sparkmagic` project. While it can be used independently, its full capabilities, dependency management, and latest compatibility fixes are often tied to `sparkmagic` updates, which might introduce their own breaking changes (e.g., `ipykernel>=6` support in `sparkmagic` 0.20.0).fixWhen integrating `autovizwidget` into a `sparkmagic`-driven environment, consult the `sparkmagic` release notes for potential ecosystem-wide dependency or behavior changes. Ensure all related packages (`ipywidgets`, `ipykernel`, `pandas`) are compatible with each other and `sparkmagic`.
affects: All versions
deprecatedThe broader `sparkmagic` project, which `autovizwidget` is a part of, dropped support for Python 3.6 in its 0.20.0 release. While `autovizwidget`'s PyPI metadata may not explicitly state a `requires_python` range, it's strongly recommended to use Python 3.7 or newer for full compatibility within the `sparkmagic` ecosystem.fixUse Python 3.7 or a newer version to maintain compatibility and receive updates.
affects: <0.20.0 (of sparkmagic, affecting autovizwidget in practice)
Upgrade
Version history
0.23.0latest on PyPI · released Jul 7, 2025
Audit
Dependencies
ipywidgetsrequiredRequired for the interactive widget GUI.
pandasrequiredCore data structure visualized by the widget.
hdijupyterutilsrequiredUtility functions from the Sparkmagic project.