GitHubGitHub Stars

Vision

Software architecture is code. Models are code. Yet most UML tools force their users into proprietary binary formats, expensive licenses or semantically weak drawing tools.

kUML rewrites that assumption: a full-fledged modelling tool that expresses UML 2, SysML 2, C4, BPMN 2.0, ERM and Service Blueprint as a type-safe Kotlin DSL. Free, versionable, precise — and deliberately designed for the LLM era.

Why kUML?

Why does anyone still need a UML tool in the age of vibe coding? Two reasons.

  1. Precise instructions for the AI. Good models express intent more clearly than pages of prose. What humans call a „specification" is, for an LLM, a deterministic context anchor — shorter, less ambiguous, cheaper per token.
  2. Human-verifiable output. The AI's work must remain auditable. And a picture is worth a thousand words — good diagrams are gold for that.

At its core, kUML is about better communication between humans and machines — in both directions.

Beyond that, professional modelling unlocks uses far outside software.Legal texts, bylaws, contracts — all documents that must be discussed before being voted on. A clean visualization makes structures, gaps and contradictions visible that inevitably get lost in running text.

Another application is the visualization of smart contractson blockchains. Diagrams make them accessible to non-developers — and even developers benefit from a precise picture over a thousand lines of Solidity or Move.

Values

  • Correctness: Models are not pretty pictures. The compiler catches what modelers miss.
  • Versionability: Plain text. Diff-friendly. Code-review-ready. Pull-request-compatible.
  • Openness: Apache 2.0. No hidden premium features. No vendor lock-in.
  • LLM suitability: Named parameters, MCP server, dedicated benchmark — designed in, not bolted on.

History

kUML started as skepticism toward the status quo: either expensive CASE tools (Enterprise Architect, MagicDraw) or semantically thin drawing tools (PlantUML, Mermaid). With Kotlin as the host language and a clear commitment to MDA, kUML is the attempt to unite both camps — and at the same time build the bridge to modern LLM workflows.

Sibling projects

kUML is the first in a family of Typed Domain Grounding DSLs applying the same architecture to other domains — same author, same conventions, same core thesis: give an LLM a statically typed DSL plus compiler feedback, and it becomes a reliable modelling partner instead of a fluent guesser.kSTEPbrings it to mechanical engineering (ISO 10303 / STEP), andkTRIZbrings it to structured innovation methodology (TRIZ).

Get involved

kUML is open source. Issues, pull requests, discussions — all welcome at github.com/kuml-dev/kUML.