Open-source 2D/3D mechanical design for machine builders, fabrication shops, fixture designers and small engineering offices: production drawings to ISO standards, with 3D parts built in. Free, local-first, no account, no cloud. Your files stay yours.
Website: https://mechpilot.agentflowbind.com · Licence: Apache-2.0 · Status: in development, milestone by milestone (see docs/roadmap.md and docs/progress.md).
- 2D first. Draw, dimension and annotate production drawings to ISO 128, ISO 129-1, ISO 7200, ISO 1101, ISO 286 and ISO 21920-1 (ASME as an option), on sheets with frames and title blocks. Export vector PDF and DXF.
- 3D where it helps. Turn a sketch into a part (extrude, revolve, holes, fillets), change a parameter and the part rebuilds, and the drawing views follow. STEP in and out.
- Checks on every change. Under-constrained sketches, missing dimensions, fits that do not exist, empty title-block fields, each with a one-click fix.
- Honest, optional AI. An assistant with your own API key that proposes changes as a preview you accept or reject, and cites its sources. The app is fully usable without it.
Done so far: M0 scaffold, M1 2D drafting (all entities, snaps, edit tools, DXF in and out), M2 dimensions and sheets (ISO 129-1 dimensions with tolerances and ISO 286 fits, symbols, ISO 5457 sheets with ISO 7200 title block, vector PDF), M3 parametric sketches (constraints solved by planegcs, driving dimensions, degrees-of-freedom colouring). 3D parts, drawings from 3D, the library and assemblies, checks and AI, and the release arrive with M4 to M8.
npm install
npm run devRequires Node 24. File > Open sample > Mounting bracket loads the sample project. Type L for a
line, C for a circle, U to undo, ZE to zoom to extents; points can be typed as 10,20 or
@50,0 (relative to the last point).
git clone https://github.com/mojeee/mechpilot && cd mechpilot && npm install(about 5 min).npm run devand open the sample project to see what exists.- Pick an issue labelled
good first issue, or fix a translation inshared/i18n/it/, or add a library value with its source underlibrary/. npm run typecheck && npm test && npm run check:licenses && npm run check:library(about 1 min). Add a test when you touch geometry or the file format.- Add a line under "Unreleased" in
CHANGELOG.md, commit withgit commit -s(DCO sign-off), open a pull request.
Read CONTRIBUTING.md for the rules and CLAUDE.md for the product rules and the architecture. Questions and ideas: GitHub Discussions.
| Folder | What |
|---|---|
app/main, app/preload, app/renderer, app/workers |
the Electron app: main process, typed bridge, UI, workers |
shared/ |
types, geometry, the document model, the command layer, the file format, i18n |
library/ |
standard data (line types, later title blocks, fits, materials, parts) with sources |
samples/ |
sample projects shipped with the app |
docs/ |
brief, roadmap, decisions, progress, file format |
site/ |
the generated website |
tests/, e2e/ |
unit tests (Vitest) and end-to-end tests (Playwright) |
Apache-2.0, copyright Mojtaba Amini. See LICENSE and NOTICE. Third-party
licences are listed in THIRD_PARTY_LICENSES.md, generated at build time; no GPL or AGPL
dependencies are accepted.
