Programmatic Timber Framing and Woodworking CAD
Kumiki is an open-source Python library for timber framing and woodworking. Designs are just programs and every joint is parametrically sized to the timbers it joins. Since everything is built from code, kumiki frames can be authored with support from AI agents.
Kigumi 0.9.11 for Mac (Apple silicon), Mac (Intel) and Windows, or as a VS Code extension. Free and open source.
tinyhouse120.pyHow it works
Built with Kumiki
Frames, joints and a finished shed. The patterns behind them ship with Kumiki.
Design with an agent
Frames are plain Python with exact dimensions, so a coding agent can write one from a description, build it, and look at what it made.
Kigumi’s agent
The agent panel in the Kigumi app and the browser version edits your frame files, checks that they build, and looks at the view. Sign in to a Kigumi account, or use your own OpenRouter key.
Your own agent
Claude Code, Codex and others can write frames too. Give them the authoring instructions, and turn on Kigumi’s MCP server in the app so they can build frames and see them.
Make me a cute saw horse. It has 2 horizontal feet on a 1′×2′ footprint, with two vertical legs on top of the feet, and a horizontal beam resting on top of the 2 legs. There should also be a stretcher connecting the 2 legs in the middle. Join everything with mortise and tenon joinery with square pegs please!
Questions
What is Kumiki?
Kumiki is an open-source Python library for designing timber frames, post-and-beam buildings and woodworking joinery in code. Its companion, Kigumi, shows the frame in 3D as you write it, with X-ray joint inspection, the CSG tree, drawings and live parameters (kiwari).
What is Kigumi, and where does it run?
Kigumi is Kumiki’s viewer and editor. It runs your frame script and renders it in 3D. Get it as a desktop app for Mac and Windows, as an extension for VS Code and Cursor, or use it in your browser at kumiki.build/try. The app and the browser version also have a built-in agent.
How does Kumiki compare to OpenSCAD, CadQuery or FreeCAD for woodworking?
General-purpose CAD is.. general purpose. Joints are difficult to draw and aren’t easily reused. Kumiki is a domain specific CAD application. Joinery (mortise and tenon, dovetails, scarfs, half-laps, gooseneck splices, housings, pegs) is created from purpose built functions that will fit the shape of the joint to whatever member it joints. And unlike FreeCAD, all designs are written with code which is best suited for agentic authoring.
Can I use AI agents (Claude, Codex, Cursor, Copilot) to design frames with Kumiki?
Yes. Frames are plain Python with exact dimensions, which agents write well. Kigumi projects ship with authoring instructions and the concepts documentation, that the agent will find automatically. Kigumi’s MCP server lets the agents you already use build frames and look at them in the app.
What joints does Kumiki support?
More than 30 traditional and modern timber joints, each with parametric variations: mortise and tenon (square, housed, through, wedged, pegged, drawbored), lap joints (corner, cross, mitered, half-blind), dovetails (standard, wedged half-dovetail, drop-in), scarf and splice joints (splined opposing scarf, lapped gooseneck or kanawa-tsugi), tongue-and-fork rafter joints, and drop-in housed joist pockets.
Can Kumiki export 3D models and files for fabrication?
Yes. Kumiki exports frames and individual timbers to STL, OBJ and 3MF for rendering and 3D printing, and to STEP for CNC and other CAD software. Drawings export as PNG and SVG will be supported soon.
Start with a mortise and tenon joint, end with a barn
kumiki is the library and kigumi is design application and environment for building kumiki frames. Installion is easy and setup is automatic.