Text to CAD (CadQuery)
This skill converts a natural language description of a 3D object into a fully functional CadQuery Python script, executes it, and delivers STL + STEP files. The workflow is designed to handle everything from simple primitives ("a cube with rounded edges") to complex mechanical assemblies ("a flanged bearing housing with bolt holes").
Phase 0: Environment Detection & Setup
Before generating any model, automatically detect a working CadQuery environment. Follow this sequence -- stop at the first success:
Check if cadquery is already importable:
python -c "import cadquery; print(cadquery.__version__)"
If this succeeds, use python directly as the interpreter.
Search for conda/mamba environments that have cadquery:
conda env list
For each environment found, test:
conda run -n <env_name> python -c "import cadquery; print(cadquery.__version__)"
If one succeeds, use conda run -n <env_name> python as the interpreter.
Search for virtual environments in the working directory or common locations (.venv, venv, env):
# Linux/macOS
.venv/bin/python -c "import cadquery; print(cadquery.__version__)"
# Windows
.venv/Scripts/python -c "import cadquery; print(cadquery.__version__)"
If no environment found, install cadquery:
- Preferred:
pip install cadquery (in current Python)
- Fallback:
conda install -c conda-forge cadquery (if conda is available)
- Confirm installation succeeded before proceeding.
Cache the result: Once a working interpreter command is found, reuse it for all subsequent executions in this session. Store it as CADQUERY_PYTHON (e.g., python, conda run -n myenv python, .venv/bin/python).
If all attempts fail, inform the user and provide manual installation instructions:
pip install cadquery
# or
conda install -c conda-forge cadquery
Phase 1: Requirement Analysis & Clarification
When the user provides a natural language description:
Parse the description to extract:
- Geometry type: primitive (box, cylinder, sphere), composite, or assembly
- Dimensions: explicit measurements (mm by default) or relative sizing
- Features: holes, fillets, chamfers, patterns, text, threads, etc.
- Spatial relationships: positions, alignments, symmetry
- Material/functional hints: load-bearing, aesthetic, printable, etc.
Fill in missing details intelligently:
- If no units specified -> assume millimeters (mm)
- If no dimensions specified -> infer reasonable engineering defaults based on the object type
- If ambiguous geometry -> choose the most common/standard engineering interpretation
- If "printable" mentioned -> ensure manifold geometry, add appropriate tolerances
Confirm understanding (brief, 2-3 sentences):
- Summarize what you will model
- State key dimensions and features
- Note any assumptions made
- Ask the user to confirm or adjust before proceeding
Phase 2: Code Generation
Generate a complete, self-contained CadQuery Python script following these mandatory rules:
Code Structure Template
"""
CadQuery Model: {model_name}
Description: {user_description}
Generated dimensions: {key_dimensions}
Units: millimeters (mm)
"""
import cadquery as cq
import os
# ============================================================
# Parameters (easy to modify)
# ============================================================
# Group all dimensional parameters at the top for easy tweaking
PARAM_NAME = value # description, unit
# ============================================================
# Output Configuration
# ============================================================
# Output to an "output" folder relative to this script's location.
# The user can override OUTPUT_DIR if they prefer a different path.
OUTPUT_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "output")
MODEL_NAME = "{model_name}"
os.makedirs(OUTPUT_DIR, exist_ok=True)
# ============================================================
# Model Construction
# ============================================================
# Build the model step by step with comments explaining each operation
result = (
cq.Workplane("XY")
.box(...)
# ... operations ...
)
# ============================================================
# Export
# ============================================================
step_path = os.path.join(OUTPUT_DIR, f"{MODEL_NAME}.step")
stl_path = os.path.join(OUTPUT_DIR, f"{MODEL_NAME}.stl")
cq.exporters.export(result, step_path)
cq.exporters.export(result, stl_path)
print(f"Model '{MODEL_NAME}' generated successfully!")
print(f" STEP: {step_path}")
print(f" STL: {stl_path}")
# Print bounding box for verification
bb = result.val().BoundingBox()
print(f" Bounding Box: {bb.xlen:.2f} x {bb.ylen:.2f} x {bb.zlen:.2f} mm")
CadQuery API Best Practices
Primitives & Basic Shapes:
cq.Workplane("XY").box(length, width, height) -- centered box
cq.Workplane("XY").cylinder(height, radius) -- centered cylinder
cq.Workplane("XY").sphere(radius) -- sphere
cq.Workplane("XY").wedge(dx, dy, dz, xmin, zmin, xmax, zmax) -- wedge/prism
2D Sketch -> 3D Extrusion (most versatile pattern):
result = (
cq.Workplane("XY")
.moveTo(x, y).lineTo(...).lineTo(...).close() # sketch profile
.extrude(height) # or .revolve(angleDegrees, axisStart, axisEnd)
)
Feature Operations:
.fillet(radius) -- round all edges (use with .edges("|Z") etc. for selective)
.chamfer(distance) -- chamfer edges
.hole(diameter, depth=None) -- through or blind hole at center
.cboreHole(diameter, cboreDiameter, cboreDepth) -- counterbore hole
.cskHole(diameter, cskDiameter, cskAngle) -- countersink hole
.shell(thickness) -- hollow out (negative = inward)
Face/Edge Selection (critical for targeted operations):
.faces(">Z") -- topmost face in Z
.faces("<Z") -- bottommost face in Z
.edges("|Z") -- edges parallel to Z
.edges(">Z") -- topmost edges in Z
.edges("%Circle") -- circular edges
.faces("+Z") -- faces with normal pointing in +Z direction
Boolean Operations:
.cut(other_shape) -- subtract
.union(other_shape) -- add
.intersect(other_shape) -- intersection
Patterns & Arrays:
.pushPoints([(x1,y1), (x2,y2), ...]) -- place features at points
.rarray(xSpacing, ySpacing, xCount, yCount) -- rectangular array
.polarArray(radius, startAngle, angle, count) -- circular array
Advanced:
.sweep(path) -- sweep a profile along a path
.loft() -- loft between profiles
.twistExtrude(height, angleDegrees) -- helical extrusion
.text("text", fontsize, distance) -- embossed/engraved text
.mirror("XY") -- mirror about a plane
.translate((x, y, z)) -- move
.rotate((0,0,0), (0,0,1), angleDeg) -- rotate
Multi-body / Assembly Pattern:
part_a = cq.Workplane("XY").box(10, 10, 10)
part_b = cq.Workplane("XY").transformed(offset=(20, 0, 0)).cylinder(10, 5)
result = part_a.union(part_b)
Code Quality Rules
- All parameters at the top -- no magic numbers in the modeling section
- Descriptive variable names --
flange_diameter, not d1
- Step-by-step comments -- explain what each operation does in context
- Build incrementally -- complex models should be built in logical stages
- Selective fillet/chamfer -- use face/edge selectors, not blanket
.fillet() which often fails
- Error-safe ordering: fillet/chamfer operations MUST come AFTER all boolean cuts/unions. Fillets on edges that get modified by later booleans will crash
- Manifold geometry -- ensure the result is a valid solid (no self-intersections)
- Reasonable tolerances -- if parts need to fit together, add 0.1-0.2mm clearance
Common Pitfalls to AVOID
.fillet() with radius >= smallest edge length -> crash. Always use conservative radii.
.shell() on complex geometry with thin walls -> often fails. Keep wall thickness reasonable.
- Chaining too many operations without
.clean() -> geometry corruption. Add .clean() after complex booleans.
- Forgetting that
.box() and .cylinder() are centered by default.
- Using
.faces(">Z").fillet() when there are multiple faces at the same Z height -> ambiguous selection.
- Applying
.fillet() before .cut() -- fillet edges may be destroyed by the cut.
Phase 3: Execution
- Determine the working directory: Use the user's current working directory (or a temporary directory) to write the script. Write the script to
{working_dir}/{model_name}.py.
- Execute using the interpreter found in Phase 0:
{CADQUERY_PYTHON} {working_dir}/{model_name}.py
Where {CADQUERY_PYTHON} is the cached interpreter command from environment detection.
- Set timeout to 60 seconds (complex models may take time)
Phase 4: Auto-Debug (up to 5 attempts)
If execution fails, follow this diagnostic protocol:
| Error Type |
Diagnosis |
Fix Strategy |
Standard_ConstructionError |
Fillet/chamfer radius too large |
Reduce radius to 50% of smallest adjacent edge |
BRep_API: not done |
Boolean operation failed |
Add .clean() before boolean; simplify geometry |
StdFail_NotDone |
Impossible geometric operation |
Re-order operations; split into sub-steps |
ValueError: No wire found |
Unclosed sketch profile |
Ensure .close() is called; check .lineTo() endpoints |
Selector found no objects |
Face/edge selector matched nothing |
Use simpler selectors; print available faces/edges for debugging |
ModuleNotFoundError |
Missing package |
Install via pip install {package} using the detected interpreter's environment, then retry. If cadquery itself is missing, re-run Phase 0 |
MemoryError or timeout |
Model too complex |
Reduce polygon count; simplify fillets |
Debug approach:
- Read the full traceback
- Identify the exact failing CadQuery operation
- Apply the targeted fix from the table above
- If unclear, add diagnostic prints:
print(result.faces().vals()) to inspect geometry state
- Rebuild and re-execute
Phase 5: Result Verification & Delivery
After successful execution:
Verify output files exist and have non-zero size
Report to user:
- Confirmation of success
- Bounding box dimensions (X x Y x Z mm)
- File paths (STEP and STL)
- Brief description of modeling approach
- Suggestions for modifications (optional parameters to tweak)
Offer follow-up options:
- "Want me to adjust any dimensions?"
- "Need additional features (holes, fillets, text)?"
- "Want to generate a variant or assembly?"
- "Need the code explained step by step?"
Phase 6: Iterative Refinement
If the user requests changes:
- Read the existing script to understand current state
- Apply targeted modifications -- don't regenerate from scratch unless major restructuring is needed
- Re-execute and verify with the same pipeline
- Show diff -- briefly describe what changed
Mechanical Parts Library (reference patterns)
Bolt/Screw:
head = cq.Workplane("XY").cylinder(head_height, head_radius)
shaft = cq.Workplane("XY").workplane(offset=-head_height).cylinder(shaft_length, shaft_radius)
result = head.union(shaft)
Gear (simplified profile):
result = (
cq.Workplane("XY")
.circle(outer_radius)
.extrude(thickness)
.faces(">Z")
.workplane()
.hole(bore_diameter)
.faces(">Z")
.workplane()
.polarArray(pitch_radius, 0, 360, num_teeth)
.rect(tooth_width, tooth_height)
.cutThruAll()
)
Enclosure/Box with lid:
body = cq.Workplane("XY").box(L, W, H).edges("|Z").fillet(corner_r).shell(-wall)
lid = cq.Workplane("XY").workplane(offset=H/2).box(L, W, lid_h).edges("|Z").fillet(corner_r)
Pipe/Tube:
result = (
cq.Workplane("XY")
.circle(outer_radius)
.circle(inner_radius) # concentric circle creates annular profile
.extrude(length)
)
Flange:
result = (
cq.Workplane("XY")
.circle(flange_radius).extrude(flange_thickness)
.faces(">Z").workplane()
.circle(pipe_radius).extrude(pipe_length)
.faces("<Z").workplane()
.pushPoints(bolt_hole_positions)
.hole(bolt_hole_diameter)
.faces("<Z").workplane()
.hole(bore_diameter)
)
Quality Checklist (verify before delivering)
Response Language
Always respond in the same language as the user's message. If the user writes in Chinese, respond in Chinese. If in English, respond in English.
1---
2name: text-to-cad
3description: "Use when the user provides a natural language description of a 3D object or mechanical part and wants to generate a CAD model. Converts the description into CadQuery Python code, automatically detects or sets up the CadQuery environment, executes the script, and produces STL and STEP output files."
4allowed-tools: []
5metadata:
6 source: https://skillmd.com/skills/spectrai-initiative/text-to-cad
7---
8
9# Text to CAD (CadQuery)
10
11This skill converts a natural language description of a 3D object into a fully functional CadQuery Python script, executes it, and delivers STL + STEP files. The workflow is designed to handle everything from simple primitives ("a cube with rounded edges") to complex mechanical assemblies ("a flanged bearing housing with bolt holes").
12
13## Phase 0: Environment Detection & Setup
14
15Before generating any model, **automatically detect a working CadQuery environment**. Follow this sequence -- stop at the first success:
16
171. **Check if `cadquery` is already importable**:
18 ```bash
19 python -c "import cadquery; print(cadquery.__version__)"
20 ```
21 If this succeeds, use `python` directly as the interpreter.
22
232. **Search for conda/mamba environments that have cadquery**:
24 ```bash
25 conda env list
26 ```
27 For each environment found, test:
28 ```bash
29 conda run -n <env_name> python -c "import cadquery; print(cadquery.__version__)"
30 ```
31 If one succeeds, use `conda run -n <env_name> python` as the interpreter.
32
333. **Search for virtual environments in the working directory or common locations** (`.venv`, `venv`, `env`):
34 ```bash
35 # Linux/macOS
36 .venv/bin/python -c "import cadquery; print(cadquery.__version__)"
37 # Windows
38 .venv/Scripts/python -c "import cadquery; print(cadquery.__version__)"
39 ```
40
414. **If no environment found, install cadquery**:
42 - Preferred: `pip install cadquery` (in current Python)
43 - Fallback: `conda install -c conda-forge cadquery` (if conda is available)
44 - Confirm installation succeeded before proceeding.
45
465. **Cache the result**: Once a working interpreter command is found, reuse it for all subsequent executions in this session. Store it as `CADQUERY_PYTHON` (e.g., `python`, `conda run -n myenv python`, `.venv/bin/python`).
47
48If all attempts fail, inform the user and provide manual installation instructions:
49```
50pip install cadquery
51# or
52conda install -c conda-forge cadquery
53```
54
55---
56
57## Phase 1: Requirement Analysis & Clarification
58
59When the user provides a natural language description:
60
611. **Parse the description** to extract:
62 - **Geometry type**: primitive (box, cylinder, sphere), composite, or assembly
63 - **Dimensions**: explicit measurements (mm by default) or relative sizing
64 - **Features**: holes, fillets, chamfers, patterns, text, threads, etc.
65 - **Spatial relationships**: positions, alignments, symmetry
66 - **Material/functional hints**: load-bearing, aesthetic, printable, etc.
67
682. **Fill in missing details intelligently**:
69 - If no units specified -> assume millimeters (mm)
70 - If no dimensions specified -> infer reasonable engineering defaults based on the object type
71 - If ambiguous geometry -> choose the most common/standard engineering interpretation
72 - If "printable" mentioned -> ensure manifold geometry, add appropriate tolerances
73
743. **Confirm understanding** (brief, 2-3 sentences):
75 - Summarize what you will model
76 - State key dimensions and features
77 - Note any assumptions made
78 - Ask the user to confirm or adjust before proceeding
79
80---
81
82## Phase 2: Code Generation
83
84Generate a complete, self-contained CadQuery Python script following these **mandatory rules**:
85
86### Code Structure Template
87
88```python
89"""
90CadQuery Model: {model_name}
91Description: {user_description}
92Generated dimensions: {key_dimensions}
93Units: millimeters (mm)
94"""
95
96import cadquery as cq
97import os
98
99# ============================================================
100# Parameters (easy to modify)
101# ============================================================
102# Group all dimensional parameters at the top for easy tweaking
103PARAM_NAME = value # description, unit
104
105# ============================================================
106# Output Configuration
107# ============================================================
108# Output to an "output" folder relative to this script's location.
109# The user can override OUTPUT_DIR if they prefer a different path.
110OUTPUT_DIR = os.path.join(os.path.dirname(os.path.abspath(__file__)), "output")
111MODEL_NAME = "{model_name}"
112
113os.makedirs(OUTPUT_DIR, exist_ok=True)
114
115# ============================================================
116# Model Construction
117# ============================================================
118# Build the model step by step with comments explaining each operation
119
120result = (
121 cq.Workplane("XY")
122 .box(...)
123 # ... operations ...
124)
125
126# ============================================================
127# Export
128# ============================================================
129step_path = os.path.join(OUTPUT_DIR, f"{MODEL_NAME}.step")
130stl_path = os.path.join(OUTPUT_DIR, f"{MODEL_NAME}.stl")
131
132cq.exporters.export(result, step_path)
133cq.exporters.export(result, stl_path)
134
135print(f"Model '{MODEL_NAME}' generated successfully!")
136print(f" STEP: {step_path}")
137print(f" STL: {stl_path}")
138
139# Print bounding box for verification
140bb = result.val().BoundingBox()
141print(f" Bounding Box: {bb.xlen:.2f} x {bb.ylen:.2f} x {bb.zlen:.2f} mm")
142```
143
144### CadQuery API Best Practices
145
146**Primitives & Basic Shapes:**
147- `cq.Workplane("XY").box(length, width, height)` -- centered box
148- `cq.Workplane("XY").cylinder(height, radius)` -- centered cylinder
149- `cq.Workplane("XY").sphere(radius)` -- sphere
150- `cq.Workplane("XY").wedge(dx, dy, dz, xmin, zmin, xmax, zmax)` -- wedge/prism
151
152**2D Sketch -> 3D Extrusion (most versatile pattern):**
153```python
154result = (
155 cq.Workplane("XY")
156 .moveTo(x, y).lineTo(...).lineTo(...).close() # sketch profile
157 .extrude(height) # or .revolve(angleDegrees, axisStart, axisEnd)
158)
159```
160
161**Feature Operations:**
162- `.fillet(radius)` -- round all edges (use with `.edges("|Z")` etc. for selective)
163- `.chamfer(distance)` -- chamfer edges
164- `.hole(diameter, depth=None)` -- through or blind hole at center
165- `.cboreHole(diameter, cboreDiameter, cboreDepth)` -- counterbore hole
166- `.cskHole(diameter, cskDiameter, cskAngle)` -- countersink hole
167- `.shell(thickness)` -- hollow out (negative = inward)
168
169**Face/Edge Selection (critical for targeted operations):**
170- `.faces(">Z")` -- topmost face in Z
171- `.faces("<Z")` -- bottommost face in Z
172- `.edges("|Z")` -- edges parallel to Z
173- `.edges(">Z")` -- topmost edges in Z
174- `.edges("%Circle")` -- circular edges
175- `.faces("+Z")` -- faces with normal pointing in +Z direction
176
177**Boolean Operations:**
178- `.cut(other_shape)` -- subtract
179- `.union(other_shape)` -- add
180- `.intersect(other_shape)` -- intersection
181
182**Patterns & Arrays:**
183- `.pushPoints([(x1,y1), (x2,y2), ...])` -- place features at points
184- `.rarray(xSpacing, ySpacing, xCount, yCount)` -- rectangular array
185- `.polarArray(radius, startAngle, angle, count)` -- circular array
186
187**Advanced:**
188- `.sweep(path)` -- sweep a profile along a path
189- `.loft()` -- loft between profiles
190- `.twistExtrude(height, angleDegrees)` -- helical extrusion
191- `.text("text", fontsize, distance)` -- embossed/engraved text
192- `.mirror("XY")` -- mirror about a plane
193- `.translate((x, y, z))` -- move
194- `.rotate((0,0,0), (0,0,1), angleDeg)` -- rotate
195
196**Multi-body / Assembly Pattern:**
197```python
198part_a = cq.Workplane("XY").box(10, 10, 10)
199part_b = cq.Workplane("XY").transformed(offset=(20, 0, 0)).cylinder(10, 5)
200result = part_a.union(part_b)
201```
202
203### Code Quality Rules
204
2051. **All parameters at the top** -- no magic numbers in the modeling section
2062. **Descriptive variable names** -- `flange_diameter`, not `d1`
2073. **Step-by-step comments** -- explain what each operation does in context
2084. **Build incrementally** -- complex models should be built in logical stages
2095. **Selective fillet/chamfer** -- use face/edge selectors, not blanket `.fillet()` which often fails
2106. **Error-safe ordering**: fillet/chamfer operations MUST come AFTER all boolean cuts/unions. Fillets on edges that get modified by later booleans will crash
2117. **Manifold geometry** -- ensure the result is a valid solid (no self-intersections)
2128. **Reasonable tolerances** -- if parts need to fit together, add 0.1-0.2mm clearance
213
214### Common Pitfalls to AVOID
215
216- `.fillet()` with radius >= smallest edge length -> crash. Always use conservative radii.
217- `.shell()` on complex geometry with thin walls -> often fails. Keep wall thickness reasonable.
218- Chaining too many operations without `.clean()` -> geometry corruption. Add `.clean()` after complex booleans.
219- Forgetting that `.box()` and `.cylinder()` are centered by default.
220- Using `.faces(">Z").fillet()` when there are multiple faces at the same Z height -> ambiguous selection.
221- Applying `.fillet()` before `.cut()` -- fillet edges may be destroyed by the cut.
222
223---
224
225## Phase 3: Execution
226
2271. **Determine the working directory**: Use the user's current working directory (or a temporary directory) to write the script. Write the script to `{working_dir}/{model_name}.py`.
2282. **Execute** using the interpreter found in Phase 0:
229 ```bash
230 {CADQUERY_PYTHON} {working_dir}/{model_name}.py
231 ```
232 Where `{CADQUERY_PYTHON}` is the cached interpreter command from environment detection.
2333. **Set timeout** to 60 seconds (complex models may take time)
234
235---
236
237## Phase 4: Auto-Debug (up to 5 attempts)
238
239If execution fails, follow this diagnostic protocol:
240
241| Error Type | Diagnosis | Fix Strategy |
242|---|---|---|
243| `Standard_ConstructionError` | Fillet/chamfer radius too large | Reduce radius to 50% of smallest adjacent edge |
244| `BRep_API: not done` | Boolean operation failed | Add `.clean()` before boolean; simplify geometry |
245| `StdFail_NotDone` | Impossible geometric operation | Re-order operations; split into sub-steps |
246| `ValueError: No wire found` | Unclosed sketch profile | Ensure `.close()` is called; check `.lineTo()` endpoints |
247| `Selector found no objects` | Face/edge selector matched nothing | Use simpler selectors; print available faces/edges for debugging |
248| `ModuleNotFoundError` | Missing package | Install via `pip install {package}` using the detected interpreter's environment, then retry. If cadquery itself is missing, re-run Phase 0 |
249| `MemoryError` or timeout | Model too complex | Reduce polygon count; simplify fillets |
250
251**Debug approach:**
2521. Read the full traceback
2532. Identify the exact failing CadQuery operation
2543. Apply the targeted fix from the table above
2554. If unclear, add diagnostic prints: `print(result.faces().vals())` to inspect geometry state
2565. Rebuild and re-execute
257
258---
259
260## Phase 5: Result Verification & Delivery
261
262After successful execution:
263
2641. **Verify output files exist** and have non-zero size
2652. **Report to user**:
266 - Confirmation of success
267 - Bounding box dimensions (X x Y x Z mm)
268 - File paths (STEP and STL)
269 - Brief description of modeling approach
270 - Suggestions for modifications (optional parameters to tweak)
271
2723. **Offer follow-up options**:
273 - "Want me to adjust any dimensions?"
274 - "Need additional features (holes, fillets, text)?"
275 - "Want to generate a variant or assembly?"
276 - "Need the code explained step by step?"
277
278---
279
280## Phase 6: Iterative Refinement
281
282If the user requests changes:
2831. **Read the existing script** to understand current state
2842. **Apply targeted modifications** -- don't regenerate from scratch unless major restructuring is needed
2853. **Re-execute and verify** with the same pipeline
2864. **Show diff** -- briefly describe what changed
287
288---
289
290## Mechanical Parts Library (reference patterns)
291
292**Bolt/Screw:**
293```python
294head = cq.Workplane("XY").cylinder(head_height, head_radius)
295shaft = cq.Workplane("XY").workplane(offset=-head_height).cylinder(shaft_length, shaft_radius)
296result = head.union(shaft)
297```
298
299**Gear (simplified profile):**
300```python
301result = (
302 cq.Workplane("XY")
303 .circle(outer_radius)
304 .extrude(thickness)
305 .faces(">Z")
306 .workplane()
307 .hole(bore_diameter)
308 .faces(">Z")
309 .workplane()
310 .polarArray(pitch_radius, 0, 360, num_teeth)
311 .rect(tooth_width, tooth_height)
312 .cutThruAll()
313)
314```
315
316**Enclosure/Box with lid:**
317```python
318body = cq.Workplane("XY").box(L, W, H).edges("|Z").fillet(corner_r).shell(-wall)
319lid = cq.Workplane("XY").workplane(offset=H/2).box(L, W, lid_h).edges("|Z").fillet(corner_r)
320```
321
322**Pipe/Tube:**
323```python
324result = (
325 cq.Workplane("XY")
326 .circle(outer_radius)
327 .circle(inner_radius) # concentric circle creates annular profile
328 .extrude(length)
329)
330```
331
332**Flange:**
333```python
334result = (
335 cq.Workplane("XY")
336 .circle(flange_radius).extrude(flange_thickness)
337 .faces(">Z").workplane()
338 .circle(pipe_radius).extrude(pipe_length)
339 .faces("<Z").workplane()
340 .pushPoints(bolt_hole_positions)
341 .hole(bolt_hole_diameter)
342 .faces("<Z").workplane()
343 .hole(bore_diameter)
344)
345```
346
347---
348
349## Quality Checklist (verify before delivering)
350
351- [ ] Script runs without errors
352- [ ] Both STL and STEP files generated with non-zero size
353- [ ] Bounding box matches expected dimensions (within 1%)
354- [ ] All user-specified features present
355- [ ] Parameters are clearly labeled and at the top of the script
356- [ ] Code is well-commented and readable
357- [ ] Fillets/chamfers applied AFTER all boolean operations
358- [ ] No magic numbers in modeling section
359
360---
361
362## Response Language
363
364Always respond in the **same language as the user's message**. If the user writes in Chinese, respond in Chinese. If in English, respond in English.