Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Aetheris documentation
Aetheris is an exact, code-first CAD system. You describe a part, an assembly or an analysis in Firmament, a small typed language, and the Aetheris compiler turns it into exact STEP AP242 B-rep geometry, with its manufacturing intent and PMI intact. When it cannot do exactly what you wrote, it stops and tells you why.
This folder is the user documentation and the authority on current behavior.
Everything else under docs/ is development history, release records or legal
drafts; the project history explains how the
system got here.
Start here
- Getting started: install the CLI and build a first part. With a release bundle, start from the bundle walkthrough.
- Learn Firmament: six short lessons, from a plate with a hole to a two-part assembly. Every example builds in CI.
- Language reference: every construct, its fields and its limits.
If you are an AI agent writing Firmament, read the lessons and the language
reference first, then the modeling strategy skill
for how to plan a part. Trust aetheris validate --json over anything you
remember: the compiler is the source of truth, and it reports every request it
cannot honour.
Guides
Parts
- Geometry and features: what each feature supports and what combines
- Closed 2D boundaries, cubic profile guides, equation curves, profile boundary edits
- Fillets and chamfers, G2 plateaus, material offsets
- Revolve, sweep, two-section loft, section chains
- Threads, perforation, gears
- Spans, Concept points and functions, derived Concept frames
- Body states and sculpting
Reuse and libraries
- Templates and product-family examples
- Patterns
- Standard Library: product families, invocation, authoring
- Standard Paperclip
- Materials
Manufacturing domains
- Sheet metal
- Molded plastic shells
- Formed wire, point wire routes, mathematical knots
- Structural members and weldments
- Piping and local autorouting
Assemblies, scenes and motion
- Assemblies, authoring foundation, components and mounting sites, datum seating
- Editable mechanisms and prescribed motion
- Inventory Records and modules, project snapshots, incremental compilation
- Scenes, OpenUSD export, GLB export
Requirements, analysis and drawings
- PMI
- Linear-elastic FEA
- Drawings: PDF, SVG and PowerPoint
- Reading engineering drawings with Drawing Notes
Existing geometry
Tools and integration
- Aetheris CAD for Blender: exact Firmament parts, editable mesh copies and STEP export
- Helios: sketching, AI author, engineering references
- Cadmata: overview, measurement, PMI, portable Windows build
- Display: Three Telos, viewport themes, surface and trim inspection
- Web SDK: getting started, build your own CAD front end, editor integration, reference editor, API reference, capability matrix, troubleshooting
- Forge Host Protocol v1: invoke Templates from Python, Go, Rust or TypeScript
- Aetheris.Fields and library boundaries
- Firmament language style and the formatter
Reference
- Language reference
- CLI
- Diagnostics
- Targets and selectors
- Supported features and known issues
- Wireframe SVG previews
- Release notes: 2.0.0, historical Preview 4 Cadmata
Showcases
- The Difference Engine: hierarchical CAD and prescribed browser animation
- Carved electric guitar and its subassemblies
- Industrial ATLAS
- Factory scene
- Code-native bracket
- Virtual sculpture: exact geometry made just for fun
Experimental
Humanoid bodies, garments and exterior reconstruction exist in the repository but are not part of the supported product.