How anteloc/ldraw-nova works
ldraw-nova is agent-oriented Python tooling for creating and reviewing LEGO models in LDraw. Its principal workflow is an agent planning a model, producing and executing a generator, and delivering LDraw source; the README describes this workflow, while the sampled code shows assembly-plan building and validation components. Separate capabilities include part and example discovery, geometry/connectivity checks, flexible-element synthesis and review, and vehicle/Technic workflows. The web app and rendering infrastructure are described as sibling-repository capabilities, not implemented in this tree. Source excerpts are partial, so uncertain runtime links are omitted.
Main entry points: builder.py Plan builder · discovery.py Part and model discovery · connectivity.py Connection analysis · flex.py Flex synthesis
Components 21
Model authoring
- Agent tools CLI
ldraw_tools/cli.py - Assembly plan
- Plan builder
ldraw_tools/builder.py - LDraw model
- Model documents
ldraw_tools/document.py - Source validation
ldraw_tools/validation.py
Discovery and references
- Part and model discovery
ldraw_tools/discovery.py - Part catalog
ldraw_tools/catalog.py - Building knowledge
ldraw_tools/knowledge.py - Build manuals
ldraw_tools/manuals.py - Part categories
data/categories/parts
Geometry and review
- Connection analysis
ldraw_tools/connectivity.py - Geometry analysis
ldraw_tools/geometry.py - Collision checks
ldraw_tools/collision.py - Technic review
ldraw_tools/technic_review.py
Specialized workflows
- Flex constraints
ldraw_tools/flex_authoring.py - Flex synthesis
ldraw_tools/flex.py - Flex review
ldraw_tools/flex_review.py - Vehicle review
ldraw_tools/vehicle_review.py - LSynth engine
Other components
- AI agent
Connections 25
- AI agent → Assembly plan: produces
- Assembly plan → Plan builder: builds from
- Plan builder → LDraw model: generates
- AI agent → Part and model discovery: finds parts
- AI agent → Part and model discovery: finds examples
- Agent tools CLI → Plan builder: invokes
ldraw_tools/cli.py - Agent tools CLI → Part and model discovery: invokes
ldraw_tools/cli.py - Plan builder → Model documents: parses sources
ldraw_tools/builder.py - Plan builder → Connection analysis: snaps placements
ldraw_tools/builder.py - Model documents → Source validation: uses validation
ldraw_tools/document.py - Part and model discovery → Model documents: inspects models
ldraw_tools/discovery.py - Part and model discovery → Part catalog: uses catalog
ldraw_tools/discovery.py - Build manuals → Plan builder: uses builder
ldraw_tools/manuals.py - Build manuals → Part and model discovery: uses discovery
ldraw_tools/manuals.py - Building knowledge → Build manuals: uses manuals
ldraw_tools/knowledge.py - Geometry analysis → Connection analysis: uses connection data
ldraw_tools/geometry.py - Connection analysis → Collision checks: checks collisions
ldraw_tools/connectivity.py - Connection analysis → Technic review: reviews placements
ldraw_tools/connectivity.py - Flex constraints → Flex synthesis: writes constraints
ldraw_tools/flex_authoring.py - Flex synthesis → LSynth engine: dispatches synthesis
ldraw_tools/flex.py - Flex review → Flex synthesis: reads flex engine
ldraw_tools/flex_review.py - Vehicle review → Geometry analysis: uses geometry
ldraw_tools/vehicle_review.py - AI agent → Technic review: checks structure
- AI agent → Flex synthesis: builds flex parts
- AI agent → Vehicle review: builds vehicles