Skip to content

Reforge

Reforge is an autonomous hardware reconstruction agent powered by GPT-6 Astra.

Code Video Cerebral Valley

Core trick

Builds a typed device model from photos and specs, then generates CAD, OpenSCAD, and tests, checking dimensions with code.

Tags

robotics/hardwaredev tools

Description

Reforge is an autonomous hardware reconstruction agent powered by GPT-6 Astra. Given incomplete visual and technical evidence for a device, Astra builds a structured model of its physical geometry, components, interfaces, and software behavior. It then turns that model into editable CAD, interface specifications, implementation scaffolding, tests, and engineering documentation. Rather than simply analyzing images or retrieving information from documents, Astra iteratively generates and validates engineering artifacts, requests additional evidence when uncertainty matters, and revises its reconstruction as new information arrives.
anushhkuh/Reforge★ 00 forksPythonMITCreated Sep 9, 2026 · last push Sep 9, 2026

README excerpt

# Reforge
### From fragments. To form.

A local-first engineering reconstruction workspace powered by **GPT-6 Astra**.
It turns incomplete mechanical evidence or recorded command/response behavior
into editable engineering artifacts, checks them, and accepts additional evidence
without discarding earlier generations.

## Two reconstruction profiles

| Profile | Evidence | Artifacts and checks |
| --- | --- | --- |
| Mechanical | 2–4 device views, one document, optional measured width | Typed features and requirements, generated OpenSCAD, actual STL and inspection renders, one visual revision, declared dimension checks, docs and mock software |
| Protocol / replay | CSV/JSONL sessions, Markdown/text notes, optional supporting images/documents | Typed protocol and state machine, trusted declarative emulator, interface/implementation scaffold, actual training and held-out replay results |

The protocol profile does not need hardware images or a CAD compiler. Its problem
is recovering a usable observable interface when the original specification is
incomplete. It does not claim to recover original firmware or undocumented internals.

## Run

```sh
cp .env.example .env
docker compose up --build
```

Open **http://localhost:8000**. The existing **Sample project** geometry flow
compiles authored CAD. Choose **Protocol / replay** for the new synthetic telemetry
sample; it computes replay results with an authored contract and needs no API key.
Samples are clearly labeled and never rep

Team