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.
- 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.
- 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.