Skip to content
3d3dcanadaPublic

About

Local CAD you can talk to: parametric B-Rep modeller, text-to-CAD, engineering drawings, print checks and an MCP server.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FORMA

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.

What it does

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

Quick start (Linux)

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 :3000

Open http://localhost:3000/?editor=1. The first start builds the studio, which takes a few minutes. Full guide: INSTALL.md.

How it fits together

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.

MCP tools

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_mcp

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

Standard parts library

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

AI generation (optional)

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

Tests

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)

Documentation

Using FORMA · The pipeline · Image to 3D · Local AI setup · Why FORMA is the geometry authority

Status

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.

Licence

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.

About

Local CAD you can talk to: parametric B-Rep modeller, text-to-CAD, engineering drawings, print checks and an MCP server.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages