Skip to main content

jupyterlab_camunda_modeller_extension

GitHub Actions npm version PyPI version Total PyPI downloads JupyterLab 4 Brought To You By KOLOMOLO Donate PayPal

Model BPMN diagrams and open Camunda BPMN files directly in JupyterLab. This extension provides a visual editor for business process modelling within the JupyterLab environment.

Screenshot

Features

  • BPMN diagram modelling - Create and edit BPMN 2.0 diagrams visually
  • Camunda BPMN support - Open and modify Camunda-specific BPMN files
  • JupyterLab integration - Native file browser integration for .bpmn files
  • Element colouring - Colour picker in the element context pad
  • Export as SVG - Download the diagram as an SVG file from the canvas context menu
  • Realign Connectors - Widen text annotations and redraw their association lines from the canvas context menu
  • Toolbar - Reload from disk, zoom out, zoom in, fit the diagram to the view, and validate
  • Text editor - Open With > Editor shows the BPMN XML with syntax highlighting, closing-tag completion and folding
  • Validation - The toolbar Validate button and the bpmn-validate command report malformed XML, broken references, elements the modeller cannot show and common modelling mistakes

Requirements

  • JupyterLab >= 4.6

Installation

pip install jupyterlab-camunda-modeller-extension

Validating BPMN files

The package installs the bpmn-validate command. It reads the files and never changes them.

bpmn-validate diagram.bpmn
bpmn-validate --json processes/*.bpmn

Each issue prints as path:line:column: severity code: message. Errors mean the file is broken; everything else is a warning. The command exits 0 when no file has an error, 1 when a file has an error, and 2 when a file cannot be read. bpmn-validate --help lists every check.

In JupyterLab, the Validate button in the diagram toolbar runs the same checks on the diagram as shown, unsaved edits included, and lists each issue with its severity, element and message.

Agent skill

The skill .agents/skills/jupyterlab-camunda-modeller-extension/SKILL.md tells AI coding agents to run bpmn-validate after editing a .bpmn file. The wheel installs it under share/jupyter/agents/skills/. Link it once, with the Python that runs JupyterLab:

mkdir -p ~/.agents/skills && ln -s "$(python -c 'import sys; print(sys.prefix)')/share/jupyter/agents/skills/jupyterlab-camunda-modeller-extension" ~/.agents/skills/jupyterlab-camunda-modeller-extension

From a clone of this repository:

ln -s "$PWD/.agents/skills/jupyterlab-camunda-modeller-extension" ~/.claude/skills/jupyterlab-camunda-modeller-extension

Uninstall

pip uninstall jupyterlab_camunda_modeller_extension

Contributing

If you would like to contribute to this extension, please refer to the Contributing Guide.


Built with the mass irony of using a visual BPMN editor to model workflows that will inevitably be replaced by an AI agent that doesn't need diagrams to understand what you meant. Until then, we'll keep drawing boxes and arrows, pretending that documenting our processes makes them more efficient - when in reality, the diagram will be outdated before the meeting to review it even starts. But hey, at least the boxes are nicely rounded and the gateway diamonds are perfectly centered.

Metadata

Release files for jupyterlab-camunda-modeller-extension 1.0.36

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jupyterlab-camunda-modeller-extension 1.0.36
File Size Uploaded Provenance Actions
jupyterlab_camunda_modeller_extension-1.0.36.tar.gz 782.9 kB Without provenance Details for jupyterlab_camunda_modeller_extension-1.0.36.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jupyterlab-camunda-modeller-extension 1.0.36
File Interpreter ABI Platform Actions
jupyterlab_camunda_modeller_extension-1.0.36-py3-none-any.whl Python 3 none any Details for jupyterlab_camunda_modeller_extension-1.0.36-py3-none-any.whl

Total release size: 1.4 MB

Release files / jupyterlab_camunda_modeller_extension-1.0.36.tar.gz

Download URL jupyterlab_camunda_modeller_extension-1.0.36.tar.gz
Size 782.9 kB
Tags Source
SHA-256 checksum
How to use checksums
db8a3ce2ea2e2312c690232c444707c9504f10a4a5da26a3bc3609b51558436d
BLAKE2b-256 checksum
How to use checksums
c9186ee4dbee5c8f0a3cc0fbebeaf79009554e942f5f12f705b441e0accbc6ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Release files / jupyterlab_camunda_modeller_extension-1.0.36-py3-none-any.whl

Download URL jupyterlab_camunda_modeller_extension-1.0.36-py3-none-any.whl
Size 589.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a35c8ba328864692e7ee9774a2b981dcc4241b699d39952e7c2f25ac7bf450b2
BLAKE2b-256 checksum
How to use checksums
aaf6fab959305aa8fc805e863f602bcfc3d2eac66fbdc25778114c52da6b8610
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for jupyterlab-camunda-modeller-extension 1.0.36

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page