Home

ForgeBoard Wiki

ForgeBoard is an AI-driven CAD assembly orchestration engine. It coordinates multi-component design, constraint-based assembly, collision detection, BOM generation, and production-ready STEP/STL export -- all powered by the Build123d CAD kernel.

Quick Start

# Install
pip install "forgeboard[all]"

# Start the MCP server for AI agent integration
forgeboard serve

# Or use the CLI directly
forgeboard design "M5 bolt flange with 4 mounting holes on 40mm PCD"
forgeboard assemble --registry assembly.yaml
forgeboard validate --assembly output/assembly.step
forgeboard bom --assembly output/assembly.step --format csv

Key Capabilities

Capability	Description
Constraint-based assembly	Mate, flush, align, offset, and angle constraints between component interfaces
Dry-fit validation	Auto-generated bounding-box proxies for early layout validation without detailed CAD models
Collision detection	Two-phase pipeline: AABB pre-filter then exact boolean intersection
BOM generation	CSV, JSON, and Markdown output with mass, material, and cost data
MCP server	Model Context Protocol integration for AI coding agents
STEP/STL export	Production-ready output in industry-standard formats
Procurement	COTS component search and buy-vs-build evaluation
Parametric dependencies	Cascade formulas propagate dimension changes across components

Wiki Pages

• MCP Server Reference -- Complete reference for all MCP tools with parameters, return values, and examples
• Dry-Fit Workflow -- Step-by-step guide for validating assembly layout before detailed CAD models exist
• Architecture -- System architecture: CadEngine Protocol, Build123d engine, assembly solver, BOM generator

Additional Documentation

These documents are maintained in the repository under docs/:

Document	Description
Assembly Guide	How to define, build, solve, validate, and export assemblies
MCP Server	MCP server setup, configuration, and tool reference
Registry Format	Component registry YAML schema
API Reference	Python API reference

License

ForgeBoard is licensed under FSL-1.1-ALv2 (Functional Source License 1.1, Apache License 2.0 Change License).