FORM
by kaizensx
README.md
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/hero-dark.svg">
<img src="docs/readme/hero-light.svg" width="828" alt="Form Studio. What are we making? Describe a part. An agent designs it as real CAD while you watch. A desk phone stand built by the CAD kernel draws itself as its edges, fills in and turns: 70.0 × 115.6 × 88.9 mm, 11 of 11 checks pass, 1 h 56 min and 72.4 g in the slicer.">
</picture>
</p>
<p align="center">
<a href="https://github.com/kaizensx/form-studio/releases/latest/download/FORM-macos-arm64.zip"><img src="docs/readme/download-macos-arm64.svg" width="168" height="56" alt="Download for macOS, Apple silicon"></a>
<a href="https://github.com/kaizensx/form-studio/releases/latest/download/FORM-macos-x64.zip"><img src="docs/readme/download-macos-x64.svg" width="168" height="56" alt="Download for macOS, Intel"></a>
<a href="https://github.com/kaizensx/form-studio/releases/latest/download/FORM-windows-x64.zip"><img src="docs/readme/download-windows-x64.svg" width="168" height="56" alt="Download for Windows, x64"></a>
<a href="https://github.com/kaizensx/form-studio/releases/latest/download/FORM-linux-x64.tar.gz"><img src="docs/readme/download-linux-x64.svg" width="168" height="56" alt="Download for Linux, x64"></a>
</p>
<p align="center">
<sub><b>Version 1.0.0</b>, the first public release · <a href="CHANGELOG.md">What is in it</a> · <a href="https://kaizensx.github.io/form-studio/#try">Try it in your browser</a> · <a href="https://kaizensx.github.io/form-studio/docs/">Docs</a> · <a href="https://discord.gg/b6ZgyndkmS">Discord</a></sub>
</p>
<br>
**Form Studio is an open-source desktop app that turns a description into a part you can make.** Type what you need, drop a photo or a sketch, or paste a link. An agent of your choice designs it as parametric B-rep geometry in [build123d](https://github.com/gumyr/build123d) on OpenCascade while you watch. Every revision is checked on the solid, sliced by your own slicer with your own presets and played back layer by layer. When you approve, the files are frozen with their hashes.
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/numbers-1-dark.svg">
<img src="docs/readme/numbers-1-light.svg" width="414" alt="7 slicers it drives for real. 74 MCP tools for any agent.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/numbers-2-dark.svg">
<img src="docs/readme/numbers-2-light.svg" width="414" alt="3 platforms: macOS, Windows and Linux. 0 uploads: your designs stay on your computer.">
</picture>
</p>
## How it works
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/steps-1-dark.svg">
<img src="docs/readme/steps-1-light.svg" width="414" alt="1, Describe: words, a photo, a sketch, a part or a link. 2, Build: your agent writes real build123d CAD, and it grows in front of you.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/steps-2-dark.svg">
<img src="docs/readme/steps-2-light.svg" width="414" alt="3, Prove: every revision is checked on the solid itself; 11 of 11 checks pass. 4, Slice: your slicer and your presets, played back layer by layer from the G-code.">
</picture>
</p>
Form Studio does not replace your CAD program or your slicer. It sits between your agent and that software and keeps the record of what was designed, checked and released. An output is current only when it exists under the hash of its inputs, so a changed clearance invalidates exactly what depends on it.
<details>
<summary><b>What runs where</b></summary>
<br>
```mermaid
flowchart LR
you(["You: words, a photo,<br/>a sketch, a part, a link"]) --> agent["Your agent<br/>app, model API or local model"]
agent -- "74 MCP tools · form CLI" --> engine["Form Studio engine<br/>parameters with provenance<br/>revisions · hashed outputs"]
engine --> kernel["CAD kernel<br/>build123d on OpenCascade"]
kernel --> checks["Checks<br/>solid · mesh · fits · joints"]
checks --> slicer["Your slicer<br/>your printer and presets"]
slicer --> release{{"You approve<br/>files frozen with SHA-256"}}
classDef datum fill:#b9e8d7,stroke:#0d1a16,color:#0d1a16
classDef plate fill:#191e22,stroke:#2a3238,color:#e8edeb
class release datum
class agent,engine,kernel,checks,slicer plate
```
| Principle | What it means |
|---|---|
| **Local** | Designs are never uploaded and prints are never started. |
| **A person releases** | Agents propose and build; only you approve the files. |
| **Every number says how it is known** | Computed, heuristic, modelled, simulated, measured or assumed. |
| **Nothing exists only in the window** | Every action is also a `form` command and an MCP tool. |
More in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
</details>
## What it does
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-start-dark.svg">
<img src="docs/readme/feature-start-light.svg" width="414" alt="Start from anything: words, a photo with a coin for scale, a sketch with real dimensions, a STEP, STL or 3MF part, a PDF drawing or a link, in one composer.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-talk-dark.svg">
<img src="docs/readme/feature-talk-light.svg" width="414" alt="Talk to any model. Agent apps: Claude Code, Codex, Gemini CLI, Cursor CLI, OpenCode, Qwen Code, GitHub Copilot CLI. Model APIs: Anthropic, OpenAI, Gemini, OpenRouter, Mistral, xAI, DeepSeek, Groq. Local: Ollama, LM Studio, llama.cpp.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-proved-dark.svg">
<img src="docs/readme/feature-proved-light.svg" width="414" alt="Proved on the solid: 11 checks pass on the desk phone stand, 8 computed, 1 heuristic and 2 model.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-move-dark.svg">
<img src="docs/readme/feature-move-light.svg" width="414" alt="Assemblies that move: the hinged box's lid swings on the lid hinge from 0 to 110 degrees; the lid hinge moves freely, 0 mm³ at 107 positions.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-slicer-dark.svg">
<img src="docs/readme/feature-slicer-light.svg" width="414" alt="Your slicer, for real: one layer of the hinged box drawn line type by line type from Bambu Studio's G-code. Bambu Studio, OrcaSlicer, PrusaSlicer, SuperSlicer, QIDISlicer, ElegooSlicer and Snapmaker Orca.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-compare-dark.svg">
<img src="docs/readme/feature-compare-light.svg" width="414" alt="Every printer compared: the desk phone stand sliced for real on five printers, with each slicer's time and filament side by side and the fastest marked.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-release-dark.svg">
<img src="docs/readme/feature-release-light.svg" width="414" alt="Release what you approved: STEP, STL, 3MF, OBJ, GLB and G-code of the desk phone stand with their SHA-256 hashes.">
</picture>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/feature-headless-dark.svg">
<img src="docs/readme/feature-headless-light.svg" width="414" alt="Everything headless: form state desk-phone-stand prints the design as JSON, with every parameter's provenance and every check.">
</picture>
</p>
> [!NOTE]
> Nothing on this page is mocked up. The parts are the CAD kernel's own meshes and edges; the checks, slicer times, G-code layers, printer comparison, joint sweep and file hashes are what a real run of the engine produced. [`scripts/readme_art.py`](scripts/readme_art.py) draws every picture again from a fresh run.
Also in 1.0.0: concepts that come back as several genuinely different designs, screw bosses and snap-fit hooks placed with a click, text on any flat face, what changed between two revisions on the solids, assembly instructions as a PDF, turntable videos, and **Just a 3D model** for designs you will not print. All of it is in the [changelog](CHANGELOG.md) and [docs/FEATURES.md](docs/FEATURES.md).
## Install
Download the app for your platform and open it. The first start installs what is missing (the standard-parts libraries, a slicer if you print, an agent and its sign-in), one click of consent each, in its own window.
<details>
<summary><b>macOS</b> · Apple silicon and Intel</summary>
<br>
Download [`FORM-macos-arm64.zip`](https://github.com/kaizensx/form-studio/releases/latest/download/FORM-macos-arm64.zip) or [`FORM-macos-x64.zip`](https://github.com/kaizensx/form-studio/releases/latest/download/FORM-macos-x64.zip), unzip it, then right-click **FORM.app** › **Open** the first time. Or from a terminal:
```bash
curl -LsSf https://raw.githubusercontent.com/kaizensx/form-studio/main/install.sh | sh
form app
```
</details>
<details>
<summary><b>Windows</b> · 10 and 11</summary>
<br>
Download [`FORM-windows-x64.zip`](https://github.com/kaizensx/form-studio/releases/latest/download/FORM-windows-x64.zip), unzip it and run `FORM.exe`; in SmartScreen choose **More info** › **Run anyway**. Or with [uv](https://docs.astral.sh/uv/):
```powershell
uv tool install --python 3.12 "form-studio[all] @ git+https://github.com/kaizensx/form-studio"
form app
```
</details>
<details>
<summary><b>Linux</b> · x64</summary>
<br>
Download [`FORM-linux-x64.tar.gz`](https://github.com/kaizensx/form-studio/releases/latest/download/FORM-linux-x64.tar.gz), unpack it and run `FORM/FORM`. Or from a terminal:
```bash
curl -LsSf https://raw.githubusercontent.com/kaizensx/form-studio/main/install.sh | sh
form app
```
</details>
Every release ships with `SHA256SUMS`, signed build provenance and an SBOM.
## Use it from your agent
Form Studio is an MCP server. Add it once and your agent can design, check, slice and prepare a release from its own window while the open app follows along. `form setup` finds the agents on your computer and writes the entry for you.
<details>
<summary><b>Claude Code</b></summary>
<br>
```bash
claude mcp add --scope user form -- form-mcp
```
Thirteen design skills (intake, parametric design, fit calibration, verify print and more) install as a plugin:
```bash
claude plugin marketplace add kaizensx/form-studio
claude plugin install form@form-studio
```
</details>
<details>
<summary><b>Codex</b></summary>
<br>
```bash
codex mcp add form -- form-mcp
```
</details>
<details>
<summary><b>Gemini CLI</b> · <code>~/.gemini/settings.json</code></summary>
<br>
```json
{ "mcpServers": { "form": { "command": "form-mcp" } } }
```
</details>
<details>
<summary><b>Cursor</b> · <code>~/.cursor/mcp.json</code></summary>
<br>
```json
{ "mcpServers": { "form": { "command": "form-mcp" } } }
```
</details>
<details>
<summary><b>Claude Desktop and any other MCP client</b></summary>
<br>
```json
{ "mcpServers": { "form": { "command": "form-mcp" } } }
```
</details>
Agents follow the same rules as the app: units in millimetres, preview before commit, provenance kept honest, and no release without a person. The guide for coding agents is [AGENTS.md](AGENTS.md); every tool is in [docs/MCP.md](docs/MCP.md).
## Headless
Every action is a `form` command that prints JSON, and every MCP tool can be called as `form tool NAME '{json}'`.
```bash
form start --text "a hook for my headphones under the desk" --photo desk.jpg # start from words and a photo
form new "Desk stand" device_stand device_width=75.6 # from a building block: solid, checks, slice
form commit desk-stand lean=18 --expect-head 1 # a new revision, rebuilt, checked and sliced
form compare-printers desk-stand # sliced on every printer you have set up
form simulate desk-stand --png print.png --layer 40 # the print at layer 40, from the G-code
form tool get_project '{"project": "desk-stand"}' # any MCP tool, from the shell
```
| | |
|---|---|
| **Every command** | [docs/CLI.md](docs/CLI.md) |
| **74 MCP tools** | [docs/MCP.md](docs/MCP.md) |
| **How the engine is built** | [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) |
## Building blocks
<p align="center"><img src="docs/images/recipes.webp" width="828" alt="Building blocks rendered by Form Studio's engine: Gridfinity bin, box with lid, phone and tablet stand, SKÅDIS pegboard accessory, self-watering planter, faceted vase, cable organizer, under-desk hanger, shelf bracket, hose adapter, battery and card holder, electronics enclosure"></p>
Agents start from parametric building blocks of the things people print most: Gridfinity bins and baseplates, boxes with sliding, press-on or hinged lids, SKÅDIS pegboard accessories, phone and tablet stands, cable organizers, under-desk hangers, shelf brackets, hose adapters, self-watering planters, faceted vases, battery and card holders and electronics enclosures. Each passes its checks at its defaults and prints without supports. Browse them, and what the community adds, in the **[recipe gallery](https://kaizensx.github.io/form-studio/recipes/)**.
## Community
**[Join the Form Studio Discord](https://discord.gg/b6ZgyndkmS)**: help, the parts people made, recipes, ideas and every release as it ships.
| | |
|---|---|
| **[Q&A](https://github.com/kaizensx/form-studio/discussions/categories/q-a)** | How to do something, or help with setup. |
| **[Printers and slicers](https://github.com/kaizensx/form-studio/discussions/categories/printers-slicers)** | Presets, filaments and slicer questions, answered by people who print. |
| **[Agents and models](https://github.com/kaizensx/form-studio/discussions/categories/agents-models)** | Which agents and models design well, and how to connect them. |
| **[Ideas](https://github.com/kaizensx/form-studio/discussions/categories/ideas)** | Talk an idea through before it becomes a feature request. |
| **[Show and tell](https://github.com/kaizensx/form-studio/discussions/categories/show-and-tell)** | The parts you made, and how they printed. |
**Contributing.** Recipes, slicer adapters, agent integrations and measured print results are all welcome: see [CONTRIBUTING.md](CONTRIBUTING.md). Branch from `dev` and open the pull request against it. To share a recipe, [open a recipe issue](https://github.com/kaizensx/form-studio/issues/new?template=3-recipe.yml) or run `form recipes submit`; it is built, checked and sliced automatically and answered with pictures.
**Security.** Report a vulnerability privately as described in [SECURITY.md](SECURITY.md). [Code of Conduct](CODE_OF_CONDUCT.md) · [Support](SUPPORT.md) · [Changelog](CHANGELOG.md)
## Licence
MIT. Form Studio calls build123d (Apache-2.0), OpenCascade (LGPL-2.1), your slicer and other programs as separate programs; none of them is bundled into its code. three.js (MIT) draws the website. Instrument Sans and Geist Mono (SIL OFL 1.1) are drawn in the app and in the pictures on this page, and Lucide icons (ISC) in the app. The Gridfinity system was created by Zack Freedman and SKÅDIS is a product of IKEA; Form Studio's building blocks follow their published dimensions and are not affiliated with either.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues