pilot

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Helps small local language models drive SolidCraft

README.md

Pilot

Pilot: helps small local models drive SolidCraft

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.

SolidCraft's Assistant: gemma4 e4b fills Pilot's plate form and SolidCraft builds a plate with four holes on a bolt circle

gemma4 e4b filling Pilot's plate form in SolidCraft 0.27.1. The wait for the model is shortened.

Discord

Get started

  1. Install Pilot from the latest release:

    System Command
    macOS (Apple silicon) and Linux, with Homebrew brew install dutchman-cad/tap/dutchman-pilot
    Windows, with Scoop scoop bucket add dutchman-cad https://github.com/dutchman-cad/scoop-bucket; scoop install dutchman-cad/dutchman-pilot
    Any, from the release archive sh install.sh (or .\install.ps1 on Windows) in the extracted folder
  2. Run a local model with Ollama, then start Pilot in front of it:

    ollama pull gemma4:e4b
    dutchman-pilot model --upstream http://localhost:11434/v1
    
  3. In SolidCraft's Assistant, add an API agent with base URL http://127.0.0.1:11500/v1
    and model gemma4: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.

an 80 x 60 x 30 mm enclosure with 2 mm walls and a lip for the lid
“an 80 x 60 x 30 mm enclosure with 2 mm walls and a lip for the lid”
a 100 x 60 x 6 mm plate with four 5 mm holes on a 40 mm bolt circle
“a 100 x 60 x 6 mm plate with four 5 mm holes on a 40 mm bolt circle”
an L profile 50 x 30 x 4 mm, 200 mm long
“an L profile 50 x 30 x 4 mm, 200 mm long”
a C channel 60 mm wide with 30 mm flanges, 4 mm thick and 150 mm long
“a C channel 60 mm wide with 30 mm flanges, 4 mm thick and 150 mm long”
a 40 mm cube with 8 mm holes through all six faces
“a 40 mm cube with 8 mm holes through all six faces”
a tube 40 mm outside diameter, 32 mm inside diameter, 100 mm long
“a tube 40 mm outside diameter, 32 mm inside diameter, 100 mm long”
a 42 mm cube with a 5 mm hole through the middle
“a 42 mm cube with a 5 mm hole through the middle”
a 100 x 80 x 5 mm plate with 8 mm rounded corners and a 3 by 4 grid of 6 mm holes 20 mm apart
“a 100 x 80 x 5 mm plate with 8 mm rounded corners and a 3 by 4 grid of 6 mm holes 20 mm apart”
a T section 60 mm wide, 40 mm tall, 5 mm thick, 120 mm long
“a T section 60 mm wide, 40 mm tall, 5 mm thick, 120 mm long”
a cylinder 10 mm across and 10 mm tall then make 12 copies of it in a row, 15 mm apart
“a cylinder 10 mm across and 10 mm tall” then “make 12 copies of it in a row, 15 mm apart”
a 60 x 40 x 20 mm box then round all edges 3 mm
“a 60 x 40 x 20 mm box” then “round all edges 3 mm”

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.

  1. 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.
  2. 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.
  3. Extras: /report bug 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

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:

SolidCraft 98 with a 40 mm box, next to its chat window: gemma4 e4b without Pilot looks for a fillet command and gives up

Without Pilot: the model searches the menus for a fillet command, finds none, and gives up.

SolidCraft 98 with the same box, its four upright edges rounded 3 mm, next to the chat window: gemma4 e4b through Pilot

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.

Yorumlar (0)

Sonuc bulunamadi