---
id: hdijupyterutils
version: "0.23.0"
license: BSD 3-clause
license_treatment: permissive
maintenance: aging
---

# hdijupyterutils — HdiJupyterUtils: Utils for Jupyter projects from HDInsight team

License: permissive · Maintenance: aging · Downloads: 1.6M/mo

## 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 above — 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

pip install hdijupyterutils
uv add hdijupyterutils
poetry add hdijupyterutils

## Installing 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: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 1.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter spark integration utilities, livy jupyter notebook magic, remote spark cluster jupyter, sparkmagic dependencies, jupyter hdinsight spark tools, interactive spark notebooks, spark kernel jupyter, jupyter-integration, spark-utilities, distributed-computing

[View on SkillFed](https://skillfed.io/packages/hdijupyterutils) · [View on PyPI](https://pypi.org/project/hdijupyterutils/)