---
id: lovely-numpy
version: "0.2.24"
license: MIT
license_treatment: permissive
maintenance: active
---

# lovely-numpy — 💟 Lovely numpy

License: permissive · Maintenance: active · Downloads: 98.2K/mo

## What it is and what it does

Lovely NumPy wraps NumPy arrays to display concise, human-readable summaries instead of raw output. When you call `lo(array)`, it shows shape, dtype, element count, memory size, value range with a histogram, mean, standard deviation, and flags for NaN or infinity values—all in a single line. For smaller arrays, it still prints the actual values.

The package also provides methods to explore nested structures (`.deeper`), visualize arrays as RGB images (`.rgb` with optional denormalization), display individual channels (`.chans`), and generate matplotlib histograms (`.plt`). It's designed for interactive debugging in Jupyter notebooks and similar environments, reducing the cognitive load of scanning large numerical outputs.

Use it for:

- Inspect tensor shapes and statistics during model training or data preprocessing without scrolling through raw arrays.
- Quickly spot NaN, infinity, or all-zero arrays that indicate bugs in numerical computations.
- Visualize image-like arrays as RGB or channel views to verify data normalization and transformations.
- Explore multi-dimensional nested structures layer-by-layer to understand data organization.
- Generate and save matplotlib plots of array distributions for documentation or reports.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a human-readable summary of NumPy arrays with shape, dtype, statistics, and special values, plus visualization methods for debugging and exploration.

Yes. Low install friction, active maintenance, MIT license, and no known vulnerabilities make it a safe addition. It directly solves a real debugging pain point—making NumPy array inspection practical in notebooks—and the visualization features add value for data exploration. Useful for anyone working with NumPy in interactive environments.

## Install

pip install lovely-numpy
uv add lovely-numpy
poetry add lovely-numpy

## Installing lovely-numpy

Before you install: Low install friction with three common dependencies (numpy, fastcore, matplotlib). Active maintenance with a recent release and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open and closed projects.

Quickstart:

pip install lovely-numpy

import numpy as np
from lovely_numpy import lo

arr = np.random.randn(100, 100)
lo(arr)

Verify before relying:

- Whether the package works with NumPy versions beyond the current ecosystem (specific version constraints not stated in fact sheet).
- Performance characteristics when inspecting very large arrays or nested structures.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 98.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

numpy array inspection, debug numpy arrays, array statistics summary, visualize numpy data, array shape and stats, jupyter-friendly, array-debugging, data-visualization

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