It is built around a simple idea: human and agent changes should use the same
canonical document model and exact kernel instead of parallel, opaque
automation state. In a browser-approved session they can revise the same open
project; the separate headless path uses its own account-owned document.
Open-source, local-first 3D parametric CAD that runs in the browser for people and permissioned typed agents, powered by OpenCascade WASM.
ดาว
504
เครื่องมือ
—
อัปไทม์
—
Local by default
Exact geometry
Shared model + kernel
Model anonymously in the browser. Optional hosted agent connectivity and headless document storage are separate, explicit choices.
OpenCascade evaluates solid B-rep geometry. The shaded three.js scene is a view of the result, not the source of truth.
People use the CAD interface. Agents use typed, permissioned operations against the same schema and kernel; browser-approved agents can edit the open project.
PartMode is free to use, inspect, modify, and self-host under the
GNU AGPL v3 license.
See PartMode in 18 seconds
Open an editable template, make a human parameter edit, approve a typed agent
change, rebuild the exact geometry, and export STEP.
The demo was captured locally from public source snapshot 8db0b804 using the
production typed-agent protocol. The complete steps and evidence are in the
capture notes.
What you can build
Area
Included capabilities
Parametric parts
Constrained sketches, dimensions and expressions, editable feature history, multiple solid bodies, direct edits, configurations, patterns, holes, threads, sheet-metal, and structural tools
Assemblies
Reusable part definitions, occurrences, mates, direct in-context component editing, exploded views, sections, dependency inspection, and assembly mass properties
Drawings
Exact OpenCascade hidden-line views; SVG and PDF sheets can carry document-owned dimensions, tolerances, notes, symbols, and tables, while DXF exports a restricted R12 orthographic or sketch geometry subset
Interchange
Editable PartMode project bundles, STEP import and export, plus STL, AMF, and 3MF mesh exports
Inspection
Measurements, geometry health, volume, surface area, material-driven mass properties, centers of mass, inertia tensors, and persistent topology evidence
Agent workflows
Hosted MCP tools for capabilities, inspection, queries, detached previews, revision-safe commits, browser artifacts, and opt-in server-headless STEP workflows
Templates are editable schema-5 starting projects, not decorative meshes.
Exact capability coverage varies by template, and a failed rebuild is reported
instead of being treated as valid geometry.
One document model, two authority paths
flowchart LR
H["Human browser UI"] --> L["Browser-local schema-5 document"]
A["Typed agent client"] --> G{"Authority chosen by account owner"}
G --> B["Browser-approved local session"]
G --> X["Headless-granted session"]
B --> L
X --> S["Account-owned schema-5 document"]
L --> K["Shared OpenCascade WASM exact kernel"]
S --> K
K --> E["Exact B-rep evidence"]
E --> O["Browser drawings and supported artifacts"]
E --> T["Headless STEP export"]
Browser-approved local projects
Anonymous browser CAD needs no account. Projects, geometry, and recovery
history remain in browser storage.
Hosted browser-agent access requires an account, a revocable agent key, a
signed-in PartMode tab, and visible approval for the project-scoped session.
A key authenticates the agent but does not grant CAD authority by itself.
Approved commands and results cross the hosted relay over HTTPS and remain
only in bounded process memory. There is no offline queue, the relay is not
end-to-end encrypted, and the browser project itself is not stored there.
The agent inspects current state, creates a detached preview, and commits only
against the matching document revision. The person can reject, pause,
disconnect, or revoke access.
Server-headless durable projects
An edit key can be created with an explicit, immutable headless grant for
unattended CAD. This is a separate storage and authority choice, not an
automatic extension of browser access.
Live headless sessions are key-bound, expire within one hour, and do not
survive a service restart. Only committed headless documents are durable.
Committed records survive session expiry, key revocation, restarts, and
deployments, and remain until account deletion; there is no individual
project-delete control yet. Headless execution has no visible Studio and a
narrower artifact surface; STEP is the current dedicated export path.
Read the agent workflow for the complete permission,
storage, session, and tool boundaries. Live cad_capabilities output remains
authoritative for the exact operations and schemas supported by a running
release.
Run locally
PartMode requires Node.js 22.13 or newer.
git clone https://github.com/BOMWiki/partmode.git
cd partmode
npm ci
npm run build
npm start
Open http://127.0.0.1:4401. Browser-local CAD does not require an account or
an external service.
To run the focused contributor gate:
npm run ci:gate
The gate type-checks and builds the release, verifies static and runtime
manifests, and exercises the local HTTP, account, identity, MCP, cloud, and
entrypoint contracts. CAD, kernel, assembly, export, and visible UI changes
also require the affected smoke:* checks. The broader blocking release gate
is available through npm run release:gate; the professional and nightly
matrices are separate.
Connect an MCP agent
Create a revocable key from Agent access, then
store it in the secret environment used to launch your MCP client. Do not paste
the key into a prompt, URL, command argument, or repository file.
Start a new session, read the PartMode Help resources, and call
cad_capabilities before constructing a transaction. Use a browser-approved
session when a person should see and approve the work, or deliberately create a
headless-granted edit key for an unattended server project.
Architecture at a glance
The browser and agent paths share the canonical document model and exact
kernel-worker boundary:
src/page.html and the focused src/static/studio-* modules implement the
visible product, documents, modeling, assemblies, drawings, storage, and
interaction behavior.
src/static/studio-drawing-*, kernel import and export handlers
the affected smoke:drawing-*, smoke:step-determinism
For CAD changes, screenshots and mesh counts are supporting evidence only.
Report the settled document result and the exact kernel, B-rep, topology, or
export evidence required by the issue. Visible behavior changes also need
browser evidence.
PartMode is engineering software, not a certification authority. Validate
dimensions, tolerances, materials, standards content, and released
manufacturing data for your application.
PartMode does not currently provide engineering simulation, certified
analysis, automated design approval, CAM, native DWG authoring, or a general
standards-certified GD&T/PMI workbench. Imported STEP does not reconstruct a
vendor's native feature history, mates, or PMI. Read
limits, evidence, and safety for the current
product boundary.
Repository scope
This repository contains the standalone PartMode product source, public
technical documentation, fixtures, and tests. Production credentials, private
operations, deployment configuration, internal handovers, and release records
are intentionally outside this repository.
The BOMWiki organization is the administrative home of this repository;
PartMode does not depend on BOMWiki applications, services, databases, ports,
or deployment infrastructure.
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
Partmode ต้องใช้ API key ไหม?
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Partmode ใช้ทรานสปอร์ตแบบใด?
Partmode ทำงานแบบโลคัลผ่าน stdio
Partmode ถูกตรวจสอบล่าสุดเมื่อใด?
ตรวจสอบล่าสุดเมื่อ 2026-10-27 Open-source, local-first 3D parametric CAD that runs in the browser for people and permissioned typed agents, powered by OpenCascade WASM.