The desktop app

Form Studio is a native desktop app for macOS, Windows and Linux, written in Qt Quick on PySide6. The interface and the 3D viewport are drawn on the GPU by Qt; the CAD engine runs in the same process, with the geometry kernel in an isolated worker. There is no browser and no web view.

Install

Download the bundle for your system from the latest release:

System File First launch
macOS, Apple Silicon FORM-macos-arm64.zip Unzip, then right-click FORM.app › Open
macOS, Intel FORM-macos-x64.zip The same
Windows 10 and 11 FORM-windows-x64.zip Unzip and run FORM.exe; in SmartScreen choose More info › Run anyway
Linux x64 FORM-linux-x64.tar.gz Unpack and run FORM/FORM

On first start Form Studio asks how you use it ("I have a 3D printer" or "I just design"), then installs what it needs by itself: the standard-parts libraries, a slicer if you print, an agent and its sign-in. It pauses only when you have to sign in or download something, and carries on once that is done. Every command is shown before it runs.

From Python

curl -LsSf https://raw.githubusercontent.com/kaizensx/form-studio/main/install.sh | sh    # macOS and Linux
form app

The script installs uv if it is missing (after asking), then Form Studio with its own Python 3.12, then runs form setup. On Windows, or to manage the install yourself:

uv tool install --python 3.12 "form-studio[all] @ git+https://github.com/kaizensx/form-studio"

The window

The workspace: conversation, viewport and stages

Area What it holds
Top bar The design and its revision, release state, its purpose, the printer (or "No printer · Just designing"), search (Ctrl/⌘ K) and Settings. A bar under it names any work that takes longer than 300 ms, with progress
Conversation (left) The agent conversation for this design: messages, the agent's steps, the views it looked at, attachments. Resizable; Ctrl/⌘ J hides it
Viewport (centre) The kernel's geometry, one mesh per feature, with dimensions on the plate. The tool rail on its left edge holds Select, Measure, Annotate, Section, Analyze, Assembly, History, Simulate the print and Photo render
Stages (right) Brief, Shape, Fit, Prove and Release. Each tab shows where it stands: measured values, features, fit yield, checks to review, release readiness
Pipeline (bottom) Parameters › Solid › Exports › Checks › Slice › Release. A node is current only when it describes the revision on screen. A 3D model, or a design that is not sliced, has no Slice step

The five stages

Stage What you do there
Brief What the part is for and its purpose (for 3D printing, or just a 3D model and how it will be made), the dimensions you measured with their provenance, reference photos and imported parts
Shape Features in build order and their parameters. Select a feature on the model or in the list and change it; the draft shows its computed impact before you commit
Fit The fit model for each interface: a section, the clearance, the chance of fitting and how to raise it. Hidden for a 3D model
Prove Every check with its evidence, print orientation, the plates, and the slice: time, filament, layers, Watch it print. A 3D model shows the checks that apply to it and says which do not
Release The release gate, approval (over failed checks only with a reason for each, on the record), the released files with their hashes, and the revision history

Home

Home is where a design starts. One composer takes whatever you have: words (typed, or spoken with your system's dictation), a photo (with a bank card, a coin or a ruler in it, the agent estimates sizes from it and labels them "estimated from the photo"), a sketch drawn on the sketch pad, a STEP, STL or 3MF part, a PDF drawing, or a link (a model page is passed to the agent as a link; a direct STL, STEP, 3MF, PDF or picture link is downloaded and shown on the composer). Drop files anywhere on Home or paste them. Under the composer: For my printer or Just a 3D model (no slicing, no print checks), and Start blank (an empty design in the workspace, no agent).

Sending opens the workspace at once in a "being designed" state with what the agent is doing; the design is attached the moment it exists and builds up feature by feature in the viewport, each feature named as it arrives. For a new idea the agent proposes three or four concepts as real CAD, side by side and turning, with a line on each and their computed size and volume: continue with one, or ask in words for a mix ("the base of A with the hook of C"). When it needs a real number, a Measure this card shows where to measure on a picture or a diagram, the tolerance that matters and what the design assumes now; the number you type is committed with how you measured it, and the part updates.

Below: concepts waiting for a pick, recent conversations, and every design as a live 3D card, filtered by released and in progress and sorted by name or date. Right-click a card to rename, duplicate, export or move it to the trash. Import (from Home or the command palette) opens a .formstudio or .formproj design, a conversation exported as JSON, or one of the shipped examples.

Sketch pad. Lines, rectangles, circles, arcs (centre, start, end), freehand strokes and dimensions, snapped to a 5 mm grid and to the points already drawn (Alt draws freely), with undo and redo. A typed dimension is "stated" and overrides the drawn length. The agent receives the shapes as structured geometry in millimetres and the picture.

Home on the first day: one composer, and what you can start from

Home with designs and recent conversations

The sketch pad

Concepts side by side

Keys

Key Does
Ctrl/⌘ K Search and commands: every action and every design
Ctrl/⌘ N New design: Home, with the composer ready
Ctrl/⌘ Shift O New conversation
Ctrl/⌘ J Show or hide the conversation
Ctrl/⌘ Shift H All designs (Home)
Ctrl/⌘ , Settings
Ctrl/⌘ 1 to 5 Brief, Shape, Fit, Prove, Release
Ctrl/⌘ Return Commit the draft
? All keys

In the viewport:

Key Does
V Select: click a feature, drag to orbit
M Measure distances, faces and diameters
X Section cut on or off
N Annotate: pick, paint or lasso, keep, ask the agent
A Analyze: thickness, overhang and other maps
E Assembly views and joints
T History: the revision timeline
F Frame the selected feature, or the whole part
1 to 5 Iso, front, side, top and underside views
. Reset the view
H / Shift H Hide the selected feature / show all
Esc Leave the tool or clear the selection

Drag to orbit, right-drag or Shift-drag to pan, scroll or pinch to zoom. Right-click a feature for quick actions.

While measuring or annotating: D distance, G face, O diameter, R edge, P point, B brush, L lasso, [ and ] brush size, Shift-click adds to the selection, Alt-drag orbits while painting.

In the conversation: Return sends, Shift Return adds a line, Up brings back your last message.

Settings

Settings (Ctrl/⌘ ,) edits studio.toml for you, with a backup of the file. A search box finds any setting, numbers are checked as you type, every value can be reset to its default, and changes apply at once: choosing the default printer updates the top bar, the plate and the open design's checks without a restart.

Settings › General

Tab Holds
General How you use Form Studio ("I have a 3D printer" or "I just design") and the project folder
Printing The default printer, filament and process, from every printer set up in your slicers; the slicer, and whether designs made for printing are sliced; the keep-out margin and the gap between parts on a plate; which program "Open in slicer" uses. Shown only when you print
Agents Agent apps, model API keys, local models and providers you added, in one list; Add a provider…; the agent, model and effort for new conversations; web lookups; a spending limit per message; opening Form Studio when an outside agent starts working. Keys are stored privately and never shown again
Other apps Blender, OpenSCAD and FreeCAD: whether and where each was found, Browse as a fallback, and what each one unlocks; which programs "Open in CAD" and "Open in viewer" use
Updates The daily check for a newer Form Studio, and the Stable or Preview channel
Advanced The slice time limit, how long the agent waits for your answers, the Claude Code command, and the printer name used when none is chosen
Software Everything Form Studio uses, what is installed, and an Install button for the rest

Settings › Agents

Settings › Printing: the default printer from your slicers, and how designs are sliced

Rules the app keeps

Build from source

uv venv --python 3.12 .venv
uv pip install --python .venv -e ".[all]" pyinstaller
.venv/bin/python -m form.app                          # run from source
.venv/bin/pyinstaller packaging/form.spec --noconfirm # build the bundle into dist/

The bundle is about 800 MB unpacked, because it carries the OpenCascade kernel and Qt. Notes for working on the interface: form/app/qml/CONTRIBUTING-UI.md.