How petermaginot/ai_piping_design works
AI Piping Design is an agent-guidance repository for turning piping prompts and visual references into FreeCAD models, then producing fabrication drawings or 2D artwork. Its principal loop is input interpretation, Quetzal-based modeling, and model verification; separate skills guide TechDraw and Draft work. FreeCAD, Quetzal, and MCP are external runtime dependencies, not implementations in this repository. The README documents these workflows, while the sampled source only confirms Quetzal discovery and table access, so finer internal call wiring is omitted.
Main entry points: quetzal_env.py Quetzal locator · quetzal-piping/SKILL.md Build and verify · techdraw-drawing/SKILL.md TechDraw guidance · draft-2d/SKILL.md Draft guidance
Components 18
Piping modeling
- Piping guidance
skills/quetzal-piping/SKILL.md - Piping specifications
skills/quetzal-piping/references/spool_prompt_template.md - Pig trap guidance
skills/quetzal-piping/references/pig_trap_guidelines.md - Build and verify
skills/quetzal-piping/SKILL.md - Piping model
Drawing outputs
- TechDraw guidance
skills/techdraw-drawing/SKILL.md - Fabrication drawing
- Draft guidance
skills/draft-2d/SKILL.md - 2D artwork
CAD runtime
- FreeCAD MCP
- FreeCAD GUI
- Quetzal workbench
- Quetzal locator
quetzal_env.py - Dimension tables
Other components
- Written prompt
- Sketch or drawing
- Field photograph
- AI agent
Connections 21
- Written prompt → AI agent: prompts
- Sketch or drawing → AI agent: interprets
- Field photograph → AI agent: interprets
- AI agent → Piping guidance: follows
- AI agent → Piping specifications: consults
- AI agent → Pig trap guidance: consults
- Piping guidance → Build and verify: guides
- AI agent → Build and verify: applies
- AI agent → FreeCAD MCP: drives
- FreeCAD MCP → FreeCAD GUI: controls
- FreeCAD GUI → Quetzal workbench: uses
- AI agent → Quetzal locator: invokes
- Quetzal locator → Quetzal workbench: locates and imports
- Quetzal locator → Dimension tables: reads
- Build and verify → Piping model: builds and checks
- TechDraw guidance → Fabrication drawing: guides creation
- AI agent → TechDraw guidance: applies
- Piping model → Fabrication drawing: documents
- Draft guidance → 2D artwork: guides creation
- AI agent → Draft guidance: applies
- FreeCAD GUI → 2D artwork: creates