Graph Editor (ge-qml)

QML port of the Digital Substrate graph editor, with an integrated Python scripting editor.

Documentation

Full documentation: https://docs.digitalsubstrate.io/reference-apps/

Part of the DevKit ecosystem.

Prerequisites

• Python 3.14+

Installation

pip install -r requirements.txt

This installs dsviper (the Viper Python binding, from PyPI) along with PySide6.

Usage

python3 graph_editor.py [database.graph]

Architecture

graph_editor.py             # entry point shim — runs graph_editor/main.py
graph_editor/               # Graph Editor app package
    main.py, Main.qml         (entry point + root QML)
    *.py, *.qml               (models, panels, dialogs)
    ge/, list/, model/,       (graph editor internals)
        render/, scripts/, images/
dsviper_components_qml/     # Shared Python models + QML components
                            # — synced from dsviper-components-qml
                            # via dev/sync_dsviper_components_qml.py
doc/                        # Technical documentation

Updating shared components

The dsviper_components_qml/ directory is sourced from dsviper-components-qml. To pull updates:

python3 dev/sync_dsviper_components_qml.py
git diff dsviper_components_qml
git commit -am "sync: bump dsviper-components-qml to vX.Y.Z"

End-user workflow: git clone && python3 graph_editor.py — dsviper_components_qml/ is committed, so no build step is required.

License

This project is licensed under the MIT License — see LICENSE.

Runtime dependency

At runtime, this project depends on the dsviper Python package (distributed on PyPI), which is proprietary (PyPI classifier License :: Other/Proprietary License). See https://pypi.org/project/dsviper/ for the package's licensing posture and contact information.