mermaid-builder
MermaidJS markup builder for Python
Decision gist · record as of 2026-08-14
Yes, if you need to generate MermaidJS diagrams programmatically and accept early-stage tooling. No external dependencies and permissive licensing make it low-risk to try. However, dormancy since June 2024 and version 0.0.3 mean incomplete features and potential gaps; verify that flowchart and sequence diagram support covers your use case before committing to it in production.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.5 or later.
- Low install friction with no runtime dependencies.
- Project is dormant since June 2024 with minimal maintenance signal, though the repository remains active and unarchived.
License · maintenance · safety
permissive license (permissive) — MIT license permits commercial and private use with minimal restrictions; suitable for most projects.
last release 2024-06-14 (791 days) · last repo commit 2024-06-22 · 4 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 437,357 downloads/mo, #6,669 on PyPI
Alternatives
Verify before relying
pip install mermaid-builder
from mermaid_builder import Chart, Node, Link
chart = Chart(title='example')
chart.add_node('start').add_node('end').add_link_between('start', 'end')
print(chart)- Whether the package handles all MermaidJS diagram types beyond flowcharts and sequence diagrams.
- Current state of the 'clone with prefix' and 'class diagrams' features listed as incomplete in the description.
What it is and what it does
mermaid-builder is a Python library that constructs MermaidJS diagram markup through object-oriented method chaining rather than manual string writing. It provides classes for Chart, Node, Link, Subgraph, SequenceDiagram, Participant, and Message, allowing you to build flowcharts and sequence diagrams programmatically and output valid MermaidJS syntax for rendering in Markdown, GitHub, or the MermaidJS playground.
The library has no external dependencies and supports Python 3.5+. It is designed to make diagram creation less error-prone and more maintainable when you need to generate diagrams dynamically or from data structures, rather than hand-writing diagram syntax. The project is in early stages (version 0.0.3) and dormant since June 2024, with some planned features still incomplete.
Use it for
- Generate flowcharts programmatically from application logic or configuration data.
- Build sequence diagrams dynamically to document API interactions or system flows.
- Create nested subgraphs and complex diagram structures without manual string escaping.
- Embed diagram generation in documentation pipelines or automated reporting tools.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to generate MermaidJS diagrams programmatically and accept early-stage tooling.
No external dependencies and permissive licensing make it low-risk to try. However, dormancy since June 2024 and version 0.0.3 mean incomplete features and potential gaps; verify that flowchart and sequence diagram support covers your use case before committing to it in production.
Install
mermaid-builder on PyPI
Before you install
Low install friction with no runtime dependencies. Project is dormant since June 2024 with minimal maintenance signal, though the repository remains active and unarchived.
Requires Python 3.5 or later.
License in practice
MIT license permits commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install mermaid-builder
from mermaid_builder import Chart, Node, Link
chart = Chart(title='example')
chart.add_node('start').add_node('end').add_link_between('start', 'end')
print(chart)Verify before relying
- Whether the package handles all MermaidJS diagram types beyond flowcharts and sequence diagrams.
- Current state of the 'clone with prefix' and 'class diagrams' features listed as incomplete in the description.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.5 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 791 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 437,357 / month, #6,669 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3 |
Evidence: mermaid_builder-0.0.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “flowchart builder programmatic”
- mermaid-builderProgrammatically generates MermaidJS diagram markup (flowcharts,…
- schemdrawSchemdraw generates high-quality electrical circuit schematic…
- blockdiagblockdiag generates block-diagram images from a dot-like text…
Give your agent the search over MCP, or paste the wish link into any chat.
More Markup packages
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
A Python markdown parser that converts markdown to HTML following the CommonMark specification, with support for plugins and custom syntax rules.
Install it if you need reliable markdown-to-HTML conversion.
Beautiful Soup parses HTML and XML documents into a navigable tree, providing Pythonic methods to search, iterate, and modify the parsed content.
Install it if you need to parse or extract data from markup documents.
et_xmlfile writes large XML files with minimal memory overhead by serializing elements to disk as they are created, rather than holding the entire tree in memory.
Install it if incremental XML writing fits your use case; skip it if your XML documents are small or you already use lxml.
Parses and edits TOML files while preserving formatting, comments, and structure, then serializes them back with layout intact.
Install it if you're building tools that touch TOML files and user readability of the source matters.
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
See also mermaid-py · mkdocs-mermaid2-plugin · sphinxcontrib-mermaid · blockdiag · django-diagram · schemdraw · plantuml · paracelsus · mkdocs-kroki-plugin · wavedrom