napari

library0.7.1pypypi✓ verified 83d ago

napari is an n-dimensional array viewer in Python, providing an interactive, multi-dimensional data viewer for scientific visualization. It emphasizes image processing and analysis, offering a flexible, plugin-friendly architecture. As of version 0.7.0, it continues active development with regular feature additions and improvements to its core architecture and ecosystem.

data ai-ml

pip install napari[all]

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · NAPARI

napari

datapythonv0.7.1

Install

43.2s avg

Import

—

Disk

1167MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.7.1 · 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

musl

py 3.10–3.920 runs

build_error

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 43.2s · import 0.000s · 1228.8MB

1167MB installed

● package 1167MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Viewer

✓ from napari import Viewer

✗ import napari; viewer = napari.Viewer()

This quickstart initializes a napari viewer, adds a simple 2D image layer generated with NumPy, and ensures the viewer's event loop is started using `napari.run()` for a responsive GUI. Replace `np.random.rand` with your actual image data.

import napari import numpy as np # Create an empty napari viewer viewer = napari.Viewer() # Add a 2D image layer with random data viewer.add_image(np.random.rand(128, 128), name='random image') # Start the napari event loop (essential for the GUI to appear and be interactive) if __name__ == '__main__': napari.run()

napari --version

Debug

Known issues

breakingStarting with napari 0.7.0, a Qt GUI backend (e.g., PyQt5, PyQt6, PySide2, PySide6) is a mandatory dependency. You must explicitly install one, or use a bundled install like `pip install napari[all]` (which installs PyQt5).

fix

Ensure you have a Qt backend installed: `pip install napari[all]` or `pip install napari[pyside6]` for a specific backend.

affects: >=0.7.0

breakingThe `Viewer` constructor no longer accepts `title` or `ndisplay` arguments directly. These attributes have moved to `viewer.window.title` and `viewer.dims.ndisplay` respectively.

fix

Instead of `viewer = napari.Viewer(title='My Viewer')`, use `viewer = napari.Viewer(); viewer.window.title = 'My Viewer'`.

affects: >=0.6.0

gotchaThe napari viewer will not display or be interactive without starting its event loop. This is typically done with `napari.run()` when the script is executed as the main program.

fix

Always include `if __name__ == '__main__': napari.run()` at the end of your script when running napari directly.

affects: all

deprecatedThe `napari.app.run()` function was removed. Use `napari.run()` instead.

fix

Update calls from `napari.app.run()` to `napari.run()`.

affects: >=0.4.17

breakingThe Layer API was significantly refactored in version 0.5.0. Direct instantiation of `napari.layers.Image` (and other layer types) for adding to the viewer is discouraged. Instead, use the `viewer.add_image()`, `viewer.add_points()`, etc., methods.

fix

Replace `viewer.add_layer(napari.layers.Image(data))` with `viewer.add_image(data)`.

affects: >=0.5.0

Upgrade

Version history

0.7.1latest on PyPI · released Jun 15, 2026

Audit

Dependencies

numpyrequiredCore dependency for n-dimensional array data structures used throughout napari.

PyQt5 / PyQt6 / PySide2 / PySide6requiredOne of these Qt GUI backends is mandatory for the viewer to function. Installing `napari[all]` will include PyQt5 by default.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/napari/napari ↗

packagehttps://pypi.org/project/napari/ ↗

homepagehttps://napari.org ↗

docshttps://napari.org ↗