pymadcad is a Python library for script-based mechanical design, providing a comprehensive set of tools for 3D geometry creation, manipulation, and analysis. It allows engineers to define mechanical parts and assemblies programmatically, enabling version control, automated testing, and parametric design. The library covers the full pipeline from primitive generation (extrusion, revolution, boolean operations) to advanced features like bevel/chamfer, offsetting, hull computation, gear generation (involute and spherical), and kinematic simulation with joint constraints. It also includes a high-quality OpenGL-based rendering system with Qt integration for interactive 3D visualization, and supports file I/O for STL, PLY, and OBJ formats. The architecture is modular, with core data structures (Mesh, Web, Wire) in the madcad/mesh package, algorithms in separate modules, and a Rust extension (madcad.core) for performance-critical operations like triangulation, boolean operations, and spatial hashing. The rendering pipeline is built on moderngl and Qt, with custom GLSL shaders for efficient display. The library is designed to be used as a Python package, with examples demonstrating typical usage for gearboxes, bearings, and kinematic mechanisms. Key reusable components include the math utilities (mathutils.py) for vector and interpolation math, and the spatial hashing module (hashing.py) for efficient proximity queries. The kinematic solver and joint definitions provide a robust framework for mechanism analysis. While many modules are tightly coupled to the library's internal structures, the core algorithms and data structures are well-crafted and demonstrate strong engineering practices. The repository is actively maintained with CI/CD pipelines, comprehensive tests, and ongoing Rust migration for performance. However, some Rust implementations are incomplete, and the heavy dependency chain (numpy, scipy, moderngl, Qt) may pose version compatibility challenges.

The LLM identified 2 files worth highlighting for reuse: