graph-notebook

library5.2.0pypypi✓ verified 84d ago

A Jupyter notebook extension for connecting to graph databases such as Amazon Neptune and JanusGraph. Version 5.2.0 provides magic commands and visualizations for SPARQL and Gremlin queries. Released monthly.

database aws

pip install graph-notebook

package ↗

INSTALL

IMPORT

SIG · GRAPH-NOTEBOOK

graph-notebook

databasepythonv5.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

GraphNotebookConfig

✓ from graph_notebook.configuration.generate_config import generate_config

✗ from graph_notebook import generate_config

Old import path moved in v4.0

Initialize a Neptune client and fetch status.

from graph_notebook.configuration.generate_config import generate_config from graph_notebook.neptune.client import NeptuneClient config = generate_config('neptune', host=os.environ.get('NEPTUNE_HOST', ''), port=8182, use_iam=False) client = NeptuneClient(config) print(client.status())

Debug

Known issues

breakingJupyterLab 4 migration: graph-notebook 5.x only supports JupyterLab 4; upgrade if using Lab 3.

fix

Use graph-notebook 4.x for JupyterLab 3 or upgrade to JupyterLab 4.

affects: >=5.0.0

gotchaMagic commands (%gremlin, %sparql) only work in notebook cells, not in scripts. Using them in plain Python files will cause SyntaxError.

fix

Use the Python API (GraphNotebookClient) instead of magic commands in scripts.

affects: all

deprecatedDeprecated: `from graph_notebook import GraphNotebookConfig` removed in v4.0. Use `from graph_notebook.configuration.generate_config import generate_config`.

fix

Use generate_config function and GraphNotebookConfig class.

affects: >=4.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'graph_notebook'

Environment not activated or package not installed.

fix

Run `pip install graph-notebook` in the correct Python environment.

PermissionError: [Errno 13] Permission denied: '/usr/local/share/jupyter/nbextensions'

Installing as root without write permissions.

fix

Install with --user flag: `pip install --user graph-notebook` or use a virtual environment.

Upgrade

Version history

5.2.0latest on PyPI · released Mar 11, 2026

Audit

Dependencies

neptune-python-utilsoptionalRequired for Gremlin connections to Neptune

SPARQLWrapperrequiredRequired for SPARQL queries

Agent activity

20 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/graph-notebook/ ↗