3d-ai-studio

Run an interactive 3D design session — turn a natural-language description (and optional reference images) into print-ready 3D files (STL + 3MF + GLB) in output/, validated for 3D printing and visually verified to match intent. Use whenever the user wants to model, design, generate, mock up, tweak, modify, or 3D-print an object — a bracket, enclosure, stand, holder, knob, gear, fixture, sign, figurine, vase, toy, or any physical part — for Bambu Studio, OrcaSlicer, PrusaSlicer, or MakerWorld. Also use to load and modify an existing STL/3MF/GLB. Triggers on "model a…", "design a…", "make me a printable…", "generate an STL of…", "tweak the…", "I want to 3D print a…".

Core concepts for agent-driven 3D modeling — constructive solid geometry (CSG), what manifold/watertight means and why it matters, coordinate systems and millimeter units, mesh vs B-rep, file formats (STL/3MF/GLB/STEP), and how to ROUTE a request to the right engine (local CSG for mechanical/functional parts vs a generative backend for organic shapes). Use to ground any 3D-generation decision before authoring.

How to author parametric 3D geometry with the studio3d CSG DSL — a manifold-by-construction Python API (box, cylinder, sphere, cone, prism, extrude, revolve, text, rounded_box, hull + boolean union/difference/intersection + transforms) that exports watertight STL/3MF/GLB. Use when writing a geometry script for the studio3d harness to build a mechanical or functional part. Covers the full API, operator overloads, transform chaining, common part recipes, and print-safe construction patterns.

Authoritative 3D-printing design rules and the print-readiness checklist for FDM and resin (SLA/MSLA). Use when modeling, reviewing, or validating any part destined for a 3D printer — wall thickness, overhangs, supports, bridging, holes, text/emboss, pins, fillets, clearances, orientation/anisotropy, elephant's-foot, units, and STL-vs-3MF choice. Encodes the 2026 AI 3D Print-Readiness Benchmark (D1 Mesh Integrity → D2 Slicer Pass → D3 Print Geometry → D4 Workflow) with hard numeric thresholds sourced from Bambu Lab, Prusa, Protolabs Network, and Formlabs.

Set up and manage the user's 3D printer profile(s) so generated files target their real machine — make/model, AMS/multi-material, and filament colors. Use when the user mentions their printer (e.g. "I have a Bambu A1"), asks to configure printing, set filament colors, switch printers, or when no active profile exists at the start of a design session. Profiles are stored cross-platform in the XDG config dir and drive bed-fit, wall minimums, and 3MF/AMS color mapping.

Run an interactive "Grill-me" design session that pins down an underspecified 3D model through focused questions, then produces a validated design plan (design.json) — the project's base design — and hands off to generation + a vision-grounded fidelity loop. Use when the user says "grill me", "design session", "help me design", "let's design a <thing>", "spec out my model", "interview me about my model", or gives a vague modeling request that needs nailing down before building. The session grounds every question in the packaged reference brief and artistic style system, asks only what is genuinely ambiguous, proposes sensible defaults, and emits a complete design plan you regenerate from on every tweak.