mirror of
https://github.com/allaunthefox/Research-Stack.git
synced 2026-08-13 16:30:34 +00:00
e5f04ee6c3
Create 4-Infrastructure/lib/ with canonical implementations of:
- hashing.py: sha256_bytes, sha256_text, sha256_file
- q16.py: Q16_16 fixed-point constants and arithmetic
- jsonl.py: load_json, load_jsonl, write_jsonl, stable_json, canonical_json_bytes
- fraction_utils.py: Fraction serialization helpers for hardware probes
Refactor 66 files across 4-Infrastructure/{hardware,shim,infra} and
5-Applications/{scripts,tools-scripts,hutter_prize,text-to-cad} to import
from the shared library instead of maintaining local copies.
4-Infrastructure/auto/lib/q16.py now re-exports from lib.q16.
Net: -743 lines (490 added, 1233 removed)
Build: not applicable (Python-only change, py_compile verified on all 71 files)
Co-Authored-By: Allaun Silverfox <bigdataiscoming+9i37y6j2@protonmail.com>
|
||
|---|---|---|
| .. | ||
| models | ||
| skills | ||
| viewer | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| LICENSE | ||
| README.md | ||
| requirements-cad.txt | ||
⚙ Open Source Text to CAD Harness ⚙
An open source harness for generating 3D models with your favorite coding agent
✨ Features
- Generate - Create source-controlled CAD models with coding agents like Codex and Claude Code.
- Export - Produce STEP, STL, DXF, GLB, topology data, and URDF robot descriptions.
- Browse - Inspect generated geometry in a local CAD Explorer viewer.
- Reference - Copy stable
@cad[...]references so agents can make precise follow-up edits. - Review - Render quick snapshots for fast checks during an iteration loop.
- Reproduce - Edit source files first, then regenerate explicit targets.
- Local - Run the harness and viewer locally with no backend to host.
🧰 Bundled Skills
This harness vendors file-targeted skills for CAD and robot-description work. Use the bundled copies here for local models/ projects, or use the dedicated repositories when installing the skills outside this harness.
- CAD Skill - STEP, STL, DXF, GLB/topology, snapshots, and
@cad[...]geometry references. Bundled docs · Standalone repo - URDF Skill - Generated URDF XML, robot links, joints, limits, validation, and mesh references. Bundled docs · Standalone repo
🔁 Workflow
- Describe - Tell your agent about the part, assembly, fixture, robot, or mechanism you want.
- Edit - Let your coding agent update CAD source files under
models/. - Regenerate - Create explicit STEP, STL, DXF, GLB, or URDF targets.
- Inspect - Open the CAD Explorer viewer to review the generated model.
- Reference - Copy
@cad[...]handles when you want geometry-aware edits. - Commit - Save the source and generated artifacts together once the model is ready.
🚀 Quick Start
Clone the repo:
git clone https://github.com/earthtojake/text-to-cad.git
cd text-to-cad
Install Python CAD dependencies:
python3.11 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
./.venv/bin/pip install -r requirements-cad.txt
Install viewer dependencies:
cd viewer
npm install
Run the local CAD Explorer:
npm run dev
Then open http://localhost:4178.