Amagine3D
Amagine3D: From hardware requirements to editable 3D designs
What is it?
What it is
Amagine3D is an open‑source 3D capability layer that converts product descriptions, reference images, and key dimensions into parametric CAD designs for hardware enclosures and assembly structures. It generates editable build123d Python source code and exports STEP, STL, and 3MF files, supporting both single‑color and multi‑color designs.
Why it exists
It exists to automate and democratize hardware creation by allowing users to specify requirements in natural language and receive ready‑to‑edit 3D designs, reducing manual CAD work and enabling rapid iteration through a 3D‑native agent that validates geometry, assembly, and manufacturing constraints.
Who should use it
Hardware engineers, product designers, makers, and developers who want to generate editable parametric 3D models from natural language descriptions and reference images, and who are comfortable with Python, Node.js, and build123d.
Who should avoid it
Users with no programming or CAD experience, those seeking a simple drag‑and‑drop modeling tool, or anyone unwilling to set up a local development environment with Node.js and Python.
Stars over time
No change stars in the last 1 day
How it works
A quick walkthrough in plain English
How Amagine3D works
Step 1 of 3
You interact with it
Open Amagine3D, send a request, or connect it to your stack.
Features
Advantages
- Open-source (Apache-2.0 license)
- Editable source code (no black box, parameters adjustable in workbench)
- No desktop CAD application required (browser-based preview with Three.js)
- Supports both single-color and multi-color output (STEP, STL, 3MF)
- Automated design validation and revision loop via 3D-native Agent
- Built on reliable open-source dependencies (build123d, OCP, Three.js, trimesh, lib3mf)
- Active development and testing in desktop Chrome and Edge
- Clear setup instructions and documentation
- Security considerations (threat model and reporting policy)
Disadvantages
- Requires specific software versions (Node.js 20.19+, Python 3.10-3.13)
- Dependent on external model gateway (LLM API) requiring configuration and potential costs
- Current release limited to parametric CAD (beyond CAD features are future work)
- Setup requires environment variable configuration (including API keys) which must be kept secure
- Agent revision loop may require multiple iterations (potential for longer processing time)
- Under active development (may have instability or breaking changes)
FAQ
What is Amagine3D and what can it do?
Amagine3D is an open-source 3D capability layer for hardware creation. It takes hardware requirements, reference images, and dimensions to automatically design enclosures and assembly structures around internal components. It produces editable source code (Python and build123d), STEP, STL, and 3MF files. The system uses a 3D-native Agent that manages the design workflow from requirements to final hardware designs.
How do I set up and run Amagine3D?
To install and run Amagine3D, clone the repository, cd into the directory, run `npm install`, copy `.env.example` to `.env`, and execute `npm run dev`. The application starts a local API on port 6161 and a web interface on port 6160. No desktop CAD application is required - the server handles all CAD operations.
What file formats can Amagine3D export?
Amagine3D can export STEP files for precise mechanical data, STL files for 3D printing, and 3MF files for multi-color designs. Color-aware 3MF exports allow generating separate STL files for each color region in a design.
How does the 3D-native Agent work?
The 3D-native Agent operates in two stages: an autonomous inner loop that iteratively generates candidate designs and checks them against physical constraints (interference, motion paths, assembly clearances), and a commit stage that validates candidates against user requirements and previous versions. Only approved candidates are committed as new design versions, preserving the complete Python source code throughout the process.
Can I provide my own prompts and generate designs?
Yes, you can use Amagine3D with natural language prompts. The system processes your requirements alongside reference images and dimensions to generate hardware enclosures. The generated designs include editable source code and various export formats. You can also configure LLM settings (like OpenAI GPT-5.5) and enable TAVILY for enhanced multimodal capabilities.
Featured in Videos
YouTube tutorials and walkthroughs for Amagine3D
Alternatives
Similar projects ranked by category, topics, and text overlap.
