Local CAD you can talk to. FORMA is a parametric 3D modeller on a real B-Rep kernel, with text-to-CAD, engineering drawings and a print check, that runs entirely on your own machine. No cloud account and no subscription.
Built by 3D3D in New Brunswick, Canada. Desktop downloads: 3d3dcanada/forma-desktop.
- Real geometry. OpenCascade B-Rep through build123d. Export STEP and STL.
- Parametric all the way. Every shape and edit lives in a feature list; change any number and the model rebuilds.
- Direct manipulation. Primitives, push/pull on faces, boolean add and cut, fillet, chamfer, shell, arrays, linked joints, split into printable pieces, undo and redo.
- Text to CAD, optional. Describe a part and FORMA writes build123d code, runs it, inspects the result and repairs it, through NVIDIA NIM or a local model. Then keep editing by hand.
- Checks before you print. Geometry lint, minimum wall thickness, support-free print orientation and a slicer handoff.
- Engineering drawings. Orthographic sheets with dimensions as DXF and PDF from any STEP.
- Agent tools. An MCP server exposes the whole pipeline to Claude Code, Codex or any MCP client.
You need Python 3.12, Node.js 20 or newer, and Git.
git clone https://github.com/3d3dcanada/forma.git
cd forma
./install.sh # Python venv, studio dependencies, selfcheck
./dev.sh # starts the geometry service on :4193 and the studio on :3000Open http://localhost:3000/?editor=1. The first start builds the studio, which takes a few minutes. Full guide: INSTALL.md.
| Path | What it is |
|---|---|
forma_cad/ |
The geometry service (python -m forma_cad.service, port 4193): parametric scene, operations, history, import and export, print checks, HTTP API. |
studio/ |
The studio: the editor you work in (Next.js and three.js, OCCT in WebAssembly for sketching), talking to the service. |
forma_mcp/ |
The MCP server (python -m forma_mcp, stdio). |
nim/ |
Text-to-build123d generation with a validate, run, inspect, repair loop. |
forma_chat/ |
A local chat service for generating and editing parts in conversation. |
overlay/ |
Engineering drawings (blueprint) and PrusaLink printer control (printer). |
domains/ |
Mechanism generators (gears, struts, fittings, clutches) and a marine parts lookup. |
skills/ |
CAD skills the service and agents use: STEP and DXF generation, viewer, SDF and URDF, G-code, Bambu and SendCutSend helpers. |
desktop/, packaging/ |
The desktop app (Tauri) and its portable Python runtime. |
forma_studio/ |
The previous web editor, still served for compatibility. |
Add FORMA to an MCP client with the command /path/to/forma/.venv/bin/python -m forma_mcp. For Claude Code:
claude mcp add forma -- /path/to/forma/.venv/bin/python -m forma_mcpTools: forma_generate, forma_pipeline, forma_inspect, forma_inspect_diff, forma_lint, forma_min_wall, forma_render, forma_blueprint, forma_lookup, forma_parts_search, forma_parts_download, forma_project_create, forma_project_list, forma_scene_types, forma_scene_state, forma_scene_add, forma_scene_update, forma_scene_delete, forma_scene_undo, forma_scene_redo, forma_printer_status, forma_printer_slice, forma_printer_upload, forma_printer_print, forma_provider_status, forma_set_key. docs/reference/forma-tools.json has every schema.
"Insert existing part" can search a library of standard parts (cable glands, bearings, knobs, hinges, project boxes and more) from the step.parts catalogue. It is not stored in this repository; download it once:
./.venv/bin/python domains/marine/scripts/download_marine_parts.pyEverything above works without any external service. For text-to-CAD, either set an NVIDIA NIM key (./.venv/bin/python -m nim config set NVIDIA_API_KEY ...) or point FORMA at a local model; see docs/reference/local-ai-setup.md.
export FORMA_CADGEN_WARM=0 FORMA_CORPUS=0 FORMA_SCENE_TOOLS_HTTP=0
./.venv/bin/python -m forma_cad.selfcheck
./.venv/bin/python -m unittest discover -s nim/tests -t .
./.venv/bin/python -m unittest discover -s forma_mcp/tests -t .
./.venv/bin/python -m forma_cad.capabilities --check-mcp
(cd studio && npm test)Using FORMA · The pipeline · Image to 3D · Local AI setup · Why FORMA is the geometry authority
Linux is the tested platform. macOS and Windows desktop builds exist but are unsigned and less tested. Printer control targets PrusaLink, built and tested on a Prusa CORE One L.
MIT. See LICENSE. FORMA began from earthtojake's open CAD skills, and its studio began from an MIT-licensed browser editor; both notices are kept in LICENSE, studio/LICENSE and THIRD_PARTY.md.