{"id":21468,"library":"ipysigma","title":"ipysigma","description":"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.","status":"active","version":"0.24.6","language":"python","source_language":"en","source_url":"https://github.com/medialab/ipysigma","tags":["jupyter","widget","network","visualization","sigma.js"],"install":[{"cmd":"pip install ipysigma","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"Correct import for the main widget class.","symbol":"Sigma","correct":"from ipysigma import Sigma"}],"quickstart":{"code":"from ipysigma import Sigma\nimport networkx as nx\n\nG = nx.karate_club_graph()\nSigma(G, node_color='club', edge_color='weight').render()\n","lang":"python","description":"Creates an interactive sigma.js network visualization from a NetworkX graph in a Jupyter notebook."},"warnings":[{"fix":"Use `from ipysigma import Sigma`.","message":"Version 0.24.0 changed the API: the main class is now `Sigma` (capital S) instead of `sigma` or `SigmaWidget`. Old imports will break.","severity":"breaking","affected_versions":"<0.24.0"},{"fix":"Replace `SigmaWidget` with `Sigma`.","message":"The `SigmaWidget` class was deprecated in 0.23.0 and removed in 0.24.0.","severity":"deprecated","affected_versions":">=0.23.0, <0.24.0"},{"fix":"Ensure ipywidgets and the JupyterLab manager are installed: `pip install ipywidgets` and `jupyter labextension install @jupyter-widgets/jupyterlab-manager`.","message":"The `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.","severity":"gotcha","affected_versions":"all"},{"fix":"Use only supported layout names: 'circle', 'random', 'forceatlas2'.","message":"The `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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `pip install ipysigma`.","cause":"The package is not installed.","error":"ModuleNotFoundError: No module named 'ipysigma'"},{"fix":"Upgrade to the latest version: `pip install --upgrade ipysigma` and use `from ipysigma import Sigma`.","cause":"Using an older version of ipysigma where the main class is named differently (e.g., sigma or SigmaWidget).","error":"ImportError: cannot import name 'Sigma' from 'ipysigma'"},{"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.","cause":"The sigma.js JavaScript library is not loaded, often because Jupyter widgets extensions are missing.","error":"Javascript error adding output! ReferenceError: sigma is not defined"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}