npimage: Load, save & manipulate numpy arrays representing images & videos

Need to load pixel values from image files as numpy arrays, and hate having to remember whether you should use PIL, tifffile, matplotlib, or something else? Hate having to deal with the fact that those libraries all use different function names and syntaxes? Wish you could just provide a filename and get back a numpy array? This library's imageio.py does that, with array = npimage.load(filename), npimage.save(array, filename), and npimage.show(array) functions that let you easily handle a number of common image file formats without having to remember library-specific syntax. Additionally, vidio.py provides array = npimage.load_video(filename) and npimage.save_video(array, filename) for videos as well. (Another similar library to consider using is imageio.)

Want to draw simple shapes like lines, triangles, and circles into 3D numpy arrays? Frustrated that the python libraries you can find online like opencv and skimage.draw work on 2D arrays but not 3D/4D/+? I wrote some functions in graphics.py that do the trick.

Documentation

imageio.py: load, save, or show images.
vidio.py: load or save videos.
graphics.py: draw points, lines, triangles, circles, or spheres into 2D/3D/+D numpy arrays representing image data.
nrrd_utils.py: compress or read metadata from .nrrd files.
operations.py: perform operations on images.

Check each function's docstring for more details.

Installation

As is always the case in python, consider making a virtual environment (using your preference of conda, virtualenv, or virtualenvwrapper) before installing.

Option 1: pip install from PyPI:

pip install numpyimage
pip install 'numpyimage[vid]'  # If you also want to install the video loading/saving dependencies
pip install 'numpyimage[align]'  # If you also want to install the image alignment dependencies
pip install 'numpyimage[all]'  # If you want to install both video and alignment dependencies

(Unfortunately the name npimage was already taken on PyPI, so pip install npimage will get you a different package.)

Option 2: pip install directly from GitHub:

pip install git+https://github.com/jasper-tms/npimage.git

Option 3: First git clone this repo and then pip install it from your clone:

cd ~/repos  # Or wherever on your computer you want to download this code to
git clone https://github.com/jasper-tms/npimage.git
cd npimage
pip install '.[all]'

After installing, you can import this package in python using import npimage (not import numpyimage!)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

numpyimage-3.10.0.tar.gz (64.3 kB view details)

Uploaded Jul 13, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

numpyimage-3.10.0-py3-none-any.whl (55.1 kB view details)

Uploaded Jul 13, 2026 Python 3

File details

Details for the file numpyimage-3.10.0.tar.gz.

File metadata

Download URL: numpyimage-3.10.0.tar.gz
Upload date: Jul 13, 2026
Size: 64.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for numpyimage-3.10.0.tar.gz
Algorithm	Hash digest
SHA256	`69f7b8ea511fa5492a23dfbf75bbe5a064d8b561a2edf9b984a3592b5729b1b9`
MD5	`604cecad632cfc753e602652922df1c3`
BLAKE2b-256	`957c8f951ec23891d4f91f37ea796025074516b23fcd80066b09f8ffb7e7a780`

See more details on using hashes here.

Provenance

The following attestation bundles were made for numpyimage-3.10.0.tar.gz:

Publisher: publish.yml on jasper-tms/npimage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: numpyimage-3.10.0.tar.gz
- Subject digest: 69f7b8ea511fa5492a23dfbf75bbe5a064d8b561a2edf9b984a3592b5729b1b9
- Sigstore transparency entry: 2163108843
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: jasper-tms/npimage@93b8b38f8cb247eec23bdc454e872249b2b20340
- Branch / Tag: refs/heads/main
- Owner: https://github.com/jasper-tms
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@93b8b38f8cb247eec23bdc454e872249b2b20340
- Trigger Event: push