Metadata-Version: 2.4
Name: sanchousf-ai-toolkit
Version: 0.3.5
Summary: AI-Toolkit: Modular CAD, AI, and Engineering Tools
Author: AI-Toolkit Contributors
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Manufacturing
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Multimedia :: Graphics :: Viewers
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dearpygui>=1.10.0
Requires-Dist: numpy>=1.22.0
Requires-Dist: scipy>=1.9.0
Requires-Dist: scikit-image>=0.19.0
Requires-Dist: trimesh>=3.15.0
Requires-Dist: PyOpenGL>=3.1.5
Requires-Dist: pillow>=9.0.0
Requires-Dist: shapely>=2.0.0
Requires-Dist: manifold3d>=3.0.0
Requires-Dist: glfw>=2.5.0
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: rich>=12.0.0
Provides-Extra: cad
Requires-Dist: dearpygui>=1.10.0; extra == "cad"
Requires-Dist: numpy>=1.22.0; extra == "cad"
Requires-Dist: scipy>=1.9.0; extra == "cad"
Requires-Dist: scikit-image>=0.19.0; extra == "cad"
Requires-Dist: trimesh>=3.15.0; extra == "cad"
Requires-Dist: PyOpenGL>=3.1.5; extra == "cad"
Requires-Dist: pillow>=9.0.0; extra == "cad"
Requires-Dist: shapely>=2.0.0; extra == "cad"
Requires-Dist: manifold3d>=3.0.0; extra == "cad"
Requires-Dist: glfw>=2.5.0; extra == "cad"
Requires-Dist: matplotlib>=3.5.0; extra == "cad"
Requires-Dist: rich>=12.0.0; extra == "cad"
Provides-Extra: remesh
Requires-Dist: pyvista>=0.40.0; extra == "remesh"
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
Requires-Dist: pyvista>=0.40.0; extra == "dev"
Requires-Dist: setuptools>=61.0; extra == "dev"
Requires-Dist: wheel; extra == "dev"
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AI Toolkit

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

---

## Toolkits & Modules

| Module | Description | Quick Links |
|---|---|---|
| **[CAD Toolkit](cad/README.md)** | Hardware-accelerated 3D CAD viewer, procedural & parametric modeling engine, CSG operations, Signed Distance Fields (SDF), 3D printability analysis, and AI Agent CollabBridge HTTP/CLI. | [Documentation](cad/README.md) • [Interactive Viewer](cad/README.md#1-launching-the-interactive-3d-viewer) • [AI Bridge](cad/README.md#3-ai-agent-collabbridge-bridgepy) |

---

## Highlights: 3D CAD Toolkit (`cad/`)

The **[CAD Toolkit](cad/README.md)** 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.
- **Automated Testing & CI**: Comprehensive 222-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](cad/README.md)**.

---

## Repository Structure

```text
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/                # 222 unit and integration tests (95% coverage)
└── LICENSE                   # Repository license
```

---

## Contributing & Development

1. Clone the repository:
   ```bash
   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`
