Mechanism-AI
Constraint-driven mechanical design agent for planar four-bar linkages, with an independent evaluator deciding pass or fail.
What it does and how it connects
Mechanism-AI is a constraint-driven mechanical design agent for planar four-bar linkages. The core principle is fixed: the AI proposes, and an independent evaluator decides whether a candidate passes. The evaluator runs deterministic checks, owns pass/fail, and never changes its acceptance criteria based on model output.
The agent works through a FastAPI run lifecycle with a three-panel React workspace: create a run, poll it, stream progress, list candidates and read JSON artifacts. Deterministic reference kinematics cover full-cycle, collision, travel, footprint and near-horizontal path checks, and an optional MuJoCo closed-loop simulation drives the crank. A parametric CAD compiler produces validated STL geometry with CadQuery and OpenCascade.
A candidate that fails evaluation produces a completed run with no_pass true, not a fake success. Collision evaluation still treats links as zero-thickness line segments, which the README lists as not wired yet, along with a broader independently reviewed benchmark suite.
Alternatives
Compare side by side- lime-slice
A filament slicer and solid modeler in one window with an MCP server, rather than a constraint-driven agent for four-bar linkages.
- freecad-3dprint
An agent skill for designing 3D-printable parts in FreeCAD with a slicer gate, rather than a linkage design agent with an independent evaluator.
- AgentCAD (lizaixi01)
A CAD runtime for AI agents that makes 2D DXF drawings, rather than a linkage design agent that compiles CadQuery geometry.
- gantry-oss
A shared ledger for people and agents developing robot hardware and software, rather than a design agent for four-bar linkages.
- agentic-robotics-benchmark
A benchmark of sandboxed agentic robotics tasks scored by a hidden grader, rather than a linkage design agent with MuJoCo simulation.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- A committed STEP file quietly stopped matching its builder code: the shell referenced faces up to 529 but the data ended at 17, importing as an invalid zero-volume shell.Error Index
- The planner's hole fill marked a 33-column gap as traversable but the sim only closes holes up to 25 columns, so MuJoCo had no floor there and the robot fell.Error Index
Sources
Not verified
- License (no LICENSE file in the repository and no license stated in the README)
- Pricing (no price stated on the repository README)
- Real user voices (recent repo activity is the maintainer's own issues)
- A named individual builder beyond the repository owner handle Farhanisto
- A public release (no releases are published)
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.