ipysigma

library0.24.6pypypi✓ verified 85d ago

A Jupyter widget using sigma.js to render interactive networks. Current version: 0.24.6. Releases are frequent with major version bumps indicating breaking changes.

web-framework data

pip install ipysigma

github ↗package ↗

INSTALL

IMPORT

SIG · IPYSIGMA

ipysigma

web-frameworkpythonv0.24.6

Install

5.4s avg

Import

1866ms

Disk

84MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.24.6 · 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.95 runs

installs and imports cleanly · install 0.0s · import 1.968s · 92MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 5.4s · import 1.764s · 92MB

84MB installed

● package 84MB

Code

Verified usage

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

Sigma

✓ from ipysigma import Sigma

Correct import for the main widget class.

Creates an interactive sigma.js network visualization from a NetworkX graph in a Jupyter notebook.

from ipysigma import Sigma import networkx as nx G = nx.karate_club_graph() Sigma(G, node_color='club', edge_color='weight').render()

Debug

Known issues

breakingVersion 0.24.0 changed the API: the main class is now `Sigma` (capital S) instead of `sigma` or `SigmaWidget`. Old imports will break.

fix

Use `from ipysigma import Sigma`.

affects: <0.24.0

deprecatedThe `SigmaWidget` class was deprecated in 0.23.0 and removed in 0.24.0.

fix

Replace `SigmaWidget` with `Sigma`.

affects: >=0.23.0, <0.24.0

gotchaThe `Sigma` widget requires Jupyter notebook or JupyterLab with the proper extension installed. In JupyterLab, you may need to run `jupyter labextension install @jupyter-widgets/jupyterlab-manager` if not already present.

fix

Ensure ipywidgets and the JupyterLab manager are installed: `pip install ipywidgets` and `jupyter labextension install @jupyter-widgets/jupyterlab-manager`.

affects: all

gotchaThe `layout` parameter in `Sigma` expects a string identifier from sigma.js (e.g., 'circle', 'random', 'forceatlas2'). If you pass an incorrect name, the layout may silently fall back to default.

fix

Use only supported layout names: 'circle', 'random', 'forceatlas2'.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'ipysigma'

The package is not installed.

fix

Run `pip install ipysigma`.

ImportError: cannot import name 'Sigma' from 'ipysigma'

Using an older version of ipysigma where the main class is named differently (e.g., sigma or SigmaWidget).

fix

Upgrade to the latest version: `pip install --upgrade ipysigma` and use `from ipysigma import Sigma`.

Javascript error adding output! ReferenceError: sigma is not defined

The sigma.js JavaScript library is not loaded, often because Jupyter widgets extensions are missing.

fix

Install ipywidgets and enable the extensions: `pip install ipywidgets` and `jupyter nbextension enable --py widgetsnbextension` for classic notebook, or `jupyter labextension install @jupyter-widgets/jupyterlab-manager` for JupyterLab.

Upgrade

Version history

0.24.6latest on PyPI · released Nov 25, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/medialab/ipysigma ↗

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