Metadata-Version: 2.4
Name: protoforge
Version: 0.1.0
Summary: Elite AI-powered CLI for virtual hardware prototyping.
License: MIT
License-File: LICENSE
Author: ProtoForge Contributors
Requires-Python: >=3.12,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: litellm (>=1.37.0,<2.0.0)
Requires-Dist: pydantic (>=2.7.1,<3.0.0)
Requires-Dist: pydantic-settings (>=2.2.1,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: pyyaml (>=6.0.1,<7.0.0)
Requires-Dist: rich (>=13.7.1,<14.0.0)
Requires-Dist: sqlmodel (>=0.0.18,<0.0.19)
Requires-Dist: typer[all] (>=0.12.3,<0.13.0)
Description-Content-Type: text/markdown

# ProtoForge: AI-Powered Virtual Hardware Prototyping

**ProtoForge** is an elite CLI tool for learning and building virtual prototypes of ANY hardware (PC, car, airplane, drone, robot, IoT device, rocket, etc.). It integrates physics simulators, firmware emulation, and AI agents to provide an end-to-end prototyping experience.

## 🚀 Key Features

- **AI Part Inventing**: Describe a part, and AI generates the parametric model (CadQuery) and physics parameters (Modelica).
- **Virtual Assembly**: Assemble complex systems in a virtual environment with ease.
- **Multi-Simulator Integration**: Connect to **Gazebo** for physics, **OpenModelica** for electronics/thermal, and **Renode** for firmware emulation.
- **Dynamic Plugin System**: "Bring your own simulator" with a plug-and-play architecture.
- **Interactive Learning**: Guided AI tutorials to help you master hardware engineering.
- **Export Ready**: Generates high-fidelity BOMs and step-by-step build instructions.

## 🛠️ Installation

```bash
# Recommended: Install via Poetry
git clone https://github.com/your-username/protoforge.git
cd protoforge
poetry install
```

## 📖 Quick Start

1. **Initialize a Project**:
   ```bash
   proto new quadcopter-project
   cd quadcopter-project
   ```

2. **Configure Your AI**:
   ```bash
   # Supports Groq, OpenAI, Ollama, etc.
   proto config model --provider groq --model llama-3.3-70b-versatile --key YOUR_API_KEY
   ```

3. **Invent Parts**:
   ```bash
   proto add mechanical "sturdy-carbon-frame" --ai-invent
   ```

4. **Visualize & Simulate**:
   ```bash
   proto view        # See it in 3D (STL export)
   proto simulate    # Run physics and firmware tests
   ```

5. **Export to Real World**:
   ```bash
   proto export      # Get your shopping list and assembly guide
   ```

## ⚖️ License

Distributed under the MIT License. See `LICENSE` for more information.

