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.

A tiny house frame designed in Kumiki
FrameTiny house
Sourcetinyhouse120.py
JointsDovetails, mortise and tenon, laps

How it works

Python in, frame out

Frame designs are parametric programs

Timbers and joints are defined through python functions provided by kumiki. All code is parametric: Change a dimension and every joint that depends on it updates. Author your code agentically or by hand.

  • Joints are functions: precise, customizable and documented
  • Patterns compose: the same brace can be used under each beam
  • Author your design together with any AI agent
Python source declaring mitered and keyed lap joints at a frame corner The shed that code builds, rendered in Kigumi

The viewer

Kigumi shows the frame as you write it

Kigumi runs your frame and draws it: as a desktop app for Mac and Windows, as a VS Code extension, or in your browser. Select a timber and read its dimensions, walk into a joint's geometry tree, hide layers, cut sections and measure.

  • Inspect geometry down to a single face, edge or joint feature
  • Layers, tags and per-member visibility for picking a frame apart
  • X-ray and section views for reading a joint from the inside
X-ray view of a double sawhorse, showing the joinery inside the timbers A coffee table frame rendered in the viewer

Joints, not boolean cuts

Traditional joints that stay correct when the timbers change

Mortise and tenon, dovetails, half-laps, scarfs, wedged and pegged variants. Each one is a parametric joint that recuts itself when the timbers it joins move, change size, or meet at a different angle.

  • Housings, shoulders, reliefs and pegs derived from the timbers,
  • Highly configurable joints for complex designs and simple plain versions for square frames
  • Dozens of joints, with more being added regularly
X-ray of a half-blind cross lap joint with keys A pegged mortise-and-tenon brace joint at an angle

Drawings

Plans and shop drawings made from the frame itself

A drawing is a projection of the model, so it cannot drift from it. Kumiki lays out the views from the timbers themselves: you never place a viewport or a scale.

  • A plan, and a dimensioned drawing for each distinct piece
  • Generated and customized in code, where the drawing is part of the design
  • Add a dimension by hand in Kigumi, and export sheets as PNG
A generated sheet: front elevation, plan, side elevation and isometric

Order of operations

The order the frame goes together, worked out from the joinery

Kumiki works out which timbers can be moved into place, and in what order, from the joints themselves. Then it plays it back so you can watch the frame come apart.

  • Assembly order derived from how each joint actually goes together
  • Scrub from assembled to disassembled to read a sequence
  • Catches a frame that cannot be assembled before you cut it
A coffee table part-way disassembled, with the assembly timeline slider The same frame at another point in the assembly sequence

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.

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