vcad
Open-source parametric CAD for the AI era.
Try it now →
Features
- Modeling — Primitives, booleans, fillets, chamfers, shell
- Sketching — 2D constraints, extrude, revolve, sweep, loft
- Assembly — Parts, instances, joints, forward kinematics
- Simulation — Physics with phyz, gym-style RL interface
- Import/Export — STEP import, STL/GLB/STEP/DXF export
- Rendering — Direct BRep ray tracing + tessellated mode
- Cloud — Supabase sync with Google/GitHub auth
Use vcad
Web App
Visit vcad.io — no install required.
Native Mac App
A native SwiftUI app lives in apple/VcadApp (macOS only;
other platforms use the web app). Build it from source:
apple/VcadApp/build-ffi.sh # build the vcad-ffi kernel static library
apple/VcadApp/bundle.sh # assemble dist/vcad.app
open apple/VcadApp/dist/vcad.app
CLI
cargo install vcad
vcad export input.vcad output.stl
vcad import-step input.step output.vcad
MCP Server (AI Agents)
The MCP server lets AI agents create and manipulate CAD models:
npm install -g @vcad/mcp
Tools: create_cad_document, export_cad, inspect_cad, gym_step, gym_reset
Rust Library
use vcad_kernel::Solid;
// Create a box with a hole
let solid = Solid::cube(100.0, 60.0, 20.0);
let hole = Solid::cylinder(10.0, 25.0, 32);
let result = solid - hole;
// Export to mesh
let mesh = result.to_mesh(32);
See crates/vcad-kernel for the full API.
Architecture
vcad/
├── crates/ # Rust BRep kernel (~35K LOC)
│ ├── vcad-kernel/ # Unified API
│ ├── vcad-kernel-topo/ # Half-edge topology
│ ├── vcad-kernel-booleans/# Boolean operations
│ └── ... # 20+ modular crates
├── packages/ # TypeScript
│ ├── app/ # React + Three.js web app
│ ├── mcp/ # MCP server for AI agents
│ └── ...
└── supabase/ # Database migrations
Development
Heads up: vcad depends on the tang math workspace and the phyz
physics workspace at sibling paths (../tang, ../phyz). Clone both
next to vcad before any cargo command, or the workspace will fail to
resolve:
git clone [email protected]:ecto/tang.git ../tang
git clone [email protected]:ecto/phyz.git ../phyz
# Rust
cargo test --workspace
cargo clippy --workspace -- -D warnings
# TypeScript
npm ci
npm run dev -w @vcad/app # Run web app locally
# Native Mac app (macOS + Xcode command-line tools)
apple/VcadApp/build-ffi.sh && apple/VcadApp/bundle.sh
Export controls
The hosted services (vcad.io and mcp.vcad.io) are not available in
jurisdictions subject to U.S. sanctions and export controls — currently
Russia, Belarus, Iran, Cuba, North Korea, Syria, and the Crimea, Sevastopol,
Donetsk, and Luhansk regions of Ukraine. Users must comply with all
applicable export laws. The open-source code in this repository is not
affected and remains available to everyone. Details in
docs/export-controls.md.
License
Copyright © 2026 Municipal Robotics Corporation
Licensed under the Apache License 2.0. See NOTICE for
attributions. Contributions are accepted under the same license per the
Apache 2.0 Section 5 inbound-equals-outbound rule.
