AI Toolkit

A modular repository of specialized engineering tools, automation workflows, and helper utilities designed for AI agents and human developers.

Toolkits & Modules

Highlights: 3D CAD Toolkit (cad/)

The CAD Toolkit provides a complete 3D modeling and visualization suite built for autonomous AI agents and pair-programming workflows:

• Interactive 3D Viewport: Fast, cross-platform UI with Dear PyGui and hardware-accelerated OpenGL offscreen rendering with CPU fallback.
• AI Agent CollabBridge: HTTP JSON API & CLI on port 8765 enabling external AI agents to query scene state, inspect geometry, command camera views, adjust live parameters, and export models.
• Procedural Modeling: Parametric primitives, CSG booleans (union, difference, intersection, chamfer, fillet) powered by Manifold3D, assemblies, and exploded views.
• Signed Distance Fields (SDF): Smooth mathematical CSG blending and high-resolution Marching Cubes meshing.
• 3D Print Preparation: Overhang detection, support volume estimation, bed boundary checks (Bambu, Prusa, Ender, Voron), and automatic print orientation optimization.
• 3D Scratchpad & Annotations: Freehand 3D surface polyline drawings with multi-color palette markers, JSON extraction, and instant solid sweep / polyline conversions.
• Automated Testing & CI: Comprehensive 314-test suite enforcing >=90% code coverage across Linux, Windows, and macOS.

For full setup instructions, CLI parameters, and developer guides, refer to the CAD Toolkit Documentation.

Repository Structure

ai-toolkit/
├── .github/
│   └── workflows/
│       └── cad.yml           # Cross-platform GitHub Actions CI for CAD
├── cad/                      # 3D Computer-Aided Design & Procedural Modeling Tool
│   ├── README.md             # In-depth CAD documentation & CLI reference
│   ├── view.py               # Interactive 3D CAD viewer
│   ├── save.py               # Headless scene exporter & snapshot generator
│   ├── bridge.py             # AI Agent CollabBridge client
│   ├── core/                 # Modeling, rendering, SDF, and geometry engine
│   ├── scenes/               # Demo procedural scenes
│   ├── scripts/              # Cross-platform environment & setup helpers
│   ├── ci/                   # Tool-specific CI composite action
│   └── tests/                # 314 unit and integration tests (>=90% coverage)
└── LICENSE                   # Repository license

Contributing & Development

1. Clone the repository:

   git clone https://github.com/sanchousf/ai-toolkit.git
   cd ai-toolkit
   

2. Navigate to the tool directory (e.g. cd cad) and run the setup script:
   • Linux / macOS / Termux: ./setup_dev.sh
   • Windows: setup_dev.bat
3. Run tests with coverage:
   • Linux / macOS / Termux: ./run_tests.sh
   • Windows: run_tests.bat