pilot
Health Warn
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Helps small local language models drive SolidCraft
Pilot
Pilot lets a small AI model running on your own computer build parts in SolidCraft:
ask for "a 42 mm cube with a 5 mm hole through the middle" and it builds it, checked.
gemma4 e4b filling Pilot's plate form in SolidCraft 0.27.1. The wait for the model is shortened.
Get started
Install Pilot from the latest release:
System Command macOS (Apple silicon) and Linux, with Homebrew brew install dutchman-cad/tap/dutchman-pilotWindows, with Scoop scoop bucket add dutchman-cad https://github.com/dutchman-cad/scoop-bucket; scoop install dutchman-cad/dutchman-pilotAny, from the release archive sh install.sh(or.\install.ps1on Windows) in the extracted folderRun a local model with Ollama, then start Pilot in front of it:
ollama pull gemma4:e4b dutchman-pilot model --upstream http://localhost:11434/v1In SolidCraft's Assistant, add an API agent with base URL
http://127.0.0.1:11500/v1
and modelgemma4:e4b. Then ask for a part.
Stuck? See First-run help. More options are in the
Assistant guide (LM Studio, and Pilot without a model) and the
install guide.
What it can build today
Each of these was built by Pilot in SolidCraft 0.27.1 from the request under it.
The full list:
- Boxes, cylinders, tubes, and spheres, with holes through them
- Holes, bolt circles, hole grids, honeycomb cuts, and cross-drilled blocks
- Plates with holes, bores, and rounded corners
- L, T, U, C, and rectangular profiles
- Enclosures with walls, a floor, and a lip for the lid
- Joints between parts, including a revolute joint on a pin
- Patterns of parts you already have
- Edits: fillets, chamfers, shells, mirrors, revolves, moves, and renames, plus measurements
Each kind and its limits are in recipes.
What Pilot actually does
Pilot is mostly a recipe engine, with a safety net for everything else.
- Recipes (almost all of the gain). For a request that fits a known part (plates,
profiles, holes and hole patterns, enclosures, patterns of parts), Pilot picks the
recipe and asks the model only to fill in its short typed form: sizes, counts, and
positions. Pilot then builds the part with checked SolidCraft commands and measures it.
When the request states every value, Pilot skips the model altogether. - Free-form help (small gain). When no recipe fits, the model drives SolidCraft's
tools itself. Pilot repairs broken tool calls, finds the right command, adds short hints,
retries, and trims old results so the context stays small. That helps a little, but a
small model still rarely finishes anything with several steps on its own. - Extras:
/reportbug reports, an opt-in--planner, and the SolidCraft 98 driver.
Every set of commands waits for your approval in SolidCraft, and SolidCraft checks every
command before it runs.
How well it works
Pilot is an early beta. On four blind test sets (56 requests never used during development,
three runs each), gemma4 e4b on 0.1.0-beta.9:
| How the part was built | Attempts | Built correctly |
|---|---|---|
| The model filled in a recipe's form | 149 | 101 (68%) |
| Pilot read every value from the request, no model | 3 | 3 |
| The model drove SolidCraft itself, with Pilot's repairs | 16 | 2 (12%) |
| All | 168 | 106 (63%) |
The same model without Pilot built 4 of the 56 (7%). So the recipes are what make a small
model useful today; outside them, expect little. 54 of the 56 test requests have a recipe,
so these numbers say more about recipe parts than about everything people ask for. Full
numbers, and results with other models, are in
the results issue.
Free-form requests are harder. A fifth blind set has everyday requests (spacers, knobs,
brackets, hinges, cable clips, and enclosures), written without looking at the recipes. Five
of its 30 requests are no longer blind, so these numbers use the other 25. gemma4 e4b, three
runs each, the same settings with and without Pilot, average parts built correctly:
| Requests | Without Pilot | With Pilot |
|---|---|---|
| A recipe was offered (15) | 3.7 (24%) | 6.0 (40%) |
| No recipe (10) | 2.0 (20%) | 3.3 (33%) |
| All 25 | 5.7 (23%) | 9.3 (37%) |
So Pilot helps on requests like these, mostly where a recipe fits, and most of them still
fail. The most common failures are holes that are missing or the wrong size, wrong overall
sizes, and missing features. Without a recipe, expect little from a small model.
Edits to an existing part: on a separate blind set of 12 edit requests, measured the same
way, gemma4 e4b built 5.3 with Pilot against 2.7 without.
Models that work
- gemma4 e4b (
ollama pull gemma4:e4b) is the recommended model and the one Pilot
is measured with. It is small enough to run on many laptops. - Larger models such as gemma4 12B and gemma4 26B did well in earlier tests. qwen2.5 7B,
qwen3 14B, gpt-oss 20B, and llama 3.1 and 3.2 have also been tried. - Any model served through Ollama, LM Studio, or another chat-completions endpoint can be
used. Numbers for each are in the results issue.
Privacy
Pilot runs on your computer and sends requests only to the model server you choose; with
Ollama or LM Studio, that is your own computer too. Pilot sends nothing anywhere else. Reports from /report are redacted, saved locally, and
only leave your computer if you submit the issue yourself.
Limits
- It is an early beta: about a third of the blind test requests still fail, most often
because the model fills in a wrong value. - It builds the kinds of parts listed above. Freeform shapes, arbitrary sketches, and large
edits to existing designs go to the model on its own, which a small model rarely gets right. - Every set of commands waits for your approval in SolidCraft, and a part Pilot built without
the model says so in its reply.
Contributing
The most useful thing is a request that went wrong: type /report in the Assistant and
submit the issue it prepares. Ideas and questions are welcome on the
Discord; code changes are described in
contributing.
Help and more
- Something wrong? Type
/reportin SolidCraft's Assistant. Pilot writes a redacted report and a
prefilled issue link you review before
sending. - Questions and discussion: the Dutchman CAD Discord.
- Your own model's results: add them to #1.
- Command-line options: MCP clients, exact matches, trimming,
text tool mode, and the planner. Every flag is in the flags reference. - Behavior and limits, measuring it,
public benchmarks, and plugin preparation. - Changelog, contributing,
security, and the contract.
SolidCraft 98
A side extra: Pilot can also drive SolidCraft 98 through its screen.
Same model (gemma4 e4b), same request ("Round the four upright edges of the box with a 3 mm
radius."), same 40 mm box:
Without Pilot: the model searches the menus for a fillet command, finds none, and gives up.
With Pilot: the model opens the box's sketch and sets its corner radius, which rounds the
four upright edges. Rounding the top and bottom edges requires SolidCraft 2000.
Both are replays of recorded runs, so they skip the model's thinking time. The run shown is the
second of two recorded tries; the first typed "3 mm" into a numbers-only field, which Pilot now
fixes. It is not reliable yet: in an earlier 11-task test with two runs each, gemma4 e4b built 2
of 22 parts through Pilot and 6 of 22 on its own; qwen2.5 7B, granite4 3B, and Muse Glimmer 30B
built none either way.
Licensed under Apache-2.0. See NOTICE.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found














