AI Agent Infers and Animates LEGO Model Mechanisms from LDraw Source Code

Automated LEGO Model Animation

An AI agent has been developed that automates the animation of LDraw LEGO models. Given an LDraw model's .mpd source code file, the agent analyzes the file to infer the model's underlying mechanical mechanisms. It then studies these discovered mechanisms to understand how different components interact.

Blender Integration for Rigging and Animation

Following the mechanical analysis, the agent plans the interactions between the model's various mechanical components. These plans are then translated into Python code specifically for Blender. This code creates the necessary rigs to control the inferred mechanisms and animates them according to the agent's plan, resulting in a functional animation of the LEGO model.

Installation and Usage

The project requires Python 3.12+ and involves cloning a GitHub repository. A setup script is provided for macOS, Linux, and Windows WSL, which installs all necessary tools and dependencies locally within the project directory. Users need to set several environment variables in their shell profile after setup. A model selector script is available to inspect and choose pre-annotated models for animation, with further guidance in a process guide.

Example and Capabilities

One example cited involves an agent using Claude Sonnet 5.5 to animate a portion of a complex model (42043-1_Flatbed-Trailer.mpd), specifically focusing on the crane due to the model's size. The animations are generated from original LEGO models, not AI-generated designs, demonstrating the agent's ability to interpret existing designs.