hdijupyterutils
HdiJupyterUtils: Utils for Jupyter projects from HDInsight team
What it is and what it does
hdijupyterutils is a utility library that underpins the Sparkmagic project, providing helper functions and Jupyter integration scaffolding for working with remote Spark clusters. It is designed to be used alongside Jupyter notebooks and the IPython ecosystem, offering utilities that abstract common operations needed when connecting to Spark via REST servers like Livy, Lighter, or Ilum.
The package depends on seven runtime components—ipython, ipywidgets, ipykernel, jupyter, pandas, numpy, and notebook—reflecting its deep integration with the Jupyter data science stack. It is primarily a support library; most users encounter it as a transitive dependency when installing Sparkmagic itself rather than as a standalone tool. The BSD 3-clause license permits unrestricted use in commercial and private projects.
Use it for:
- Supporting Sparkmagic's Jupyter kernel implementations to enable automatic Spark context creation and SQL query execution.
- Providing shared utility functions across Sparkmagic's multiple authentication methods (Basic, Kerberos, custom).
- Enabling visualization and dataframe capture workflows in Jupyter notebooks connected to remote Spark clusters.
- Facilitating local-to-remote data transfer and Spark job configuration management from Jupyter.
- Abstracting REST communication details when interacting with Livy or other Spark session servers.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides utility functions and Jupyter integration helpers for the Sparkmagic project, enabling interactive Spark cluster access through Jupyter notebooks via REST-based Livy, Lighter, or Ilum servers.
Yes, but typically as a transitive dependency of Sparkmagic rather than directly. If you are setting up Sparkmagic for interactive Spark work in Jupyter, this will be installed automatically. Install it explicitly only if you are developing Sparkmagic extensions or utilities. The aging maintenance status (403 days since last release) warrants monitoring, but no security vulnerabilities are known and the BSD license poses no restrictions.
Install
hdijupyterutils on PyPI
pip
pip install hdijupyterutilsuv
uv add hdijupyterutilspoetry
poetry add hdijupyterutilsInstalling hdijupyterutils
Before you install
Low install friction with a pure-Python wheel distribution. Maintenance is aging—last release was 403 days ago—but the repository remains active and unarchived with modest community engagement (1366 stars).
License in practice
BSD 3-clause permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice preservation.
Quickstart
pip install hdijupyterutils
from hdijupyterutils.utils import get_variable_name
from hdijupyterutils.sparkmagic_utils import get_spark_context
Intended as a support library for Sparkmagic; direct standalone use is uncommon. Requires Jupyter and IPython ecosystem already installed.
Verify before relying
- Whether this package is intended for direct end-user installation or primarily as a transitive dependency of Sparkmagic.
- Current maintenance status and whether the 403-day gap since last release indicates active development or dormancy.
- Python version support beyond the classifier mentioning 3.7; compatibility with modern Python versions.
Package facts
| License | BSD 3-clause (permissive) |
| Python support | not specified |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 7 — ipython, ipywidgets, ipykernel, jupyter, pandas, numpy, notebook |
| Maintenance | aging — 403 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,609,412/month — #3,722 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: hdijupyterutils-0.23.0-py3-none-any.whl
Tags
More Distributed Computing packages
gRPC Python is an HTTP/2-based RPC framework…
permissive · top 100 on PyPI
execnetexecnet lets you spawn and communicate with…
permissive · top 1,000 on PyPI
cloudpickleCloudpickle extends Python's standard pickle…
permissive · top 1,000 on PyPI
smart-openProvides a unified, open()-compatible Python…
permissive · top 1,000 on PyPI
portalockerPortalocker provides cross-platform file…
permissive · top 1,000 on PyPI
rayRay is a distributed computing framework that…
permissive · top 1,000 on PyPI
autovizwidgetAutovizwidget automatically generates…
permissive · top 5,000 on PyPI
livyA Python client for Apache Livy that enables…
permissive · top 15,000 on PyPI
emr-notebooks-magicsProvides iPython magics for Amazon EMR…
permissive · top 5,000 on PyPI
pyspark-clientPython client for connecting to Apache Spark…
permissive · top 5,000 on PyPI
ipymplipympl enables interactive matplotlib plots in…
permissive · top 5,000 on PyPI
pyspark-pandasProvides tools for distributing Pandas…
unclear · top 5,000 on PyPI
ipywidgetsipywidgets provides interactive HTML widgets…
permissive · top 1,000 on PyPI
ipyvueProvides a Jupyter widget base for building…
permissive · top 15,000 on PyPI
apache-airflow-providers-apache-livyIntegrates Apache Livy with Apache Airflow to…
permissive · top 15,000 on PyPI
databricks-connectDatabricks Connect is a client library that…
unclear · top 5,000 on PyPI