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
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: cad
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
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`
