Nodelace
Nodelace renders polished architecture, flow, and sequence diagrams from a small text language. Rendering is deterministic and entirely local: the base package has no runtime dependencies, AI calls, network requests, telemetry, Graphviz, browser, or Node.js requirement.
python -m pip install nodelace
Create system.diagram:
architecture "Small Web Service"
direction left-to-right
Browser -> API: HTTPS
API -> Database: query
highlight API
Then validate and render it:
nodelace check system.diagram
nodelace render system.diagram
The default artifact is system.svg. Standalone HTML is also available:
nodelace render system.diagram --format html -o system.html
The Python API accepts source text or an immutable parsed model:
from nodelace import parse_diagram, render
diagram = parse_diagram('flow "Two Steps"\nStart -> Finish')
svg = render(diagram)
Nodelace provides:
- architecture, flow, and basic sequence diagrams;
- deterministic layered and participant-lane layout;
- orthogonal connectors, cycles, flat groups, and focal highlights;
- accessible SVG title and description metadata;
- self-contained offline SVG/HTML with bundled OFL-1.1 fonts and notices;
- a strict, non-executable UTF-8 language with bounded input limits;
- a dependency-free Python 3.11+ runtime and typed public API.
Current limits include flat groups only, Latin coverage in the bundled fonts, no full UML sequence fragments, a 50-node safety ceiling, and SVG/HTML output only. Other Unicode text remains valid and selectable but may use a viewer's installed fallback font.
The source distribution contains the complete language and architecture
references under docs/, plus ten source examples, byte-verified SVGs, and an
offline gallery under examples/.
Nodelace code is MIT licensed. Instrument Serif, Geist, and Geist Mono remain under the SIL Open Font License 1.1; their complete notices ship in the package and in artifacts that embed the fonts.
The design goals were inspired by Kathryn Lavery's diagram-design work. Nodelace is an independent deterministic implementation and does not package or invoke that AI-oriented skill.
Metadata
Release files for nodelace 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nodelace-0.1.0.tar.gz | 2.7 MB | With provenance | Details for nodelace-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nodelace-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for nodelace-0.1.0-py3-none-any.whl |
Total release size: 2.9 MB
Release files / nodelace-0.1.0.tar.gz
| Download URL | nodelace-0.1.0.tar.gz |
|---|---|
| Size | 2.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9aa38ce4bfa493320026aa53a26100af22366a2e34757df8ad4cf5764480eea5
|
|
BLAKE2b-256 checksum How to use checksums |
df2c7156066c7f8ac444c966b4487b4216337bd8aaf629d0cdf0b125a980cce7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 15, 2026.
Transparency logRelease files / nodelace-0.1.0-py3-none-any.whl
| Download URL | nodelace-0.1.0-py3-none-any.whl |
|---|---|
| Size | 241.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cbef7301e7dd8efb43f8b5a78cf82e77628e0b57f9426b3c119317c9bd1b0db4
|
|
BLAKE2b-256 checksum How to use checksums |
594e57156d235327d51a4f65c68b46a42928e19935837a82a7df90aeb5d6830c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 15, 2026.
Transparency logSecurity for nodelace 0.1.0
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for nodelace-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 15, 2026.
Transparency logA 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.