axiolid 0.1.0

Status: early kernel. Axiolid has real, tested building blocks and strict architecture gates, but it is not yet a drop-in replacement for an established CAD kernel. The capability page separates implemented behavior from contracts and planned work.

Why Axiolid?

Geometry infrastructure should not force an application into a source format, a native toolchain, one hardware API, or a monolithic dependency graph. Axiolid is a small, composable Rust workspace for applications that need a neutral geometry layer between imported data and execution.

• Format-neutral: no IFC, STEP, CAD, renderer, or GPU API vocabulary in the kernel model.
• Pure Rust: no C++ or OpenCascade dependency graph.
• Pay for capability: use a leaf crate, the small axiolid facade, or opt into algorithms and execution contexts deliberately.
• Honest seams: stable data and operation contracts are separate from providers; a provider advertises only what it implements.
• Portable correctness first: the reference package is the scalar oracle for optimized paths; CPU dispatch is runtime-selected, never target-cpu=native.

Read the documentation site for architecture, capability status, decisions, and contributor guidance.

Quick start

Add the facade for core values, meshes, and the portable CPU shell:

[dependencies]
axiolid = { git = "https://github.com/axiolid/kernel.git" }

The always-available core vocabulary is deliberately small:

use axiolid::{Point3, Tolerance};

let origin = Point3::new(0.0, 0.0, 0.0);
let tolerance = Tolerance::METRE;

assert!(origin.is_finite());
assert!(tolerance.linear() >= 0.0);

For narrow dependency graphs, depend directly on leaf crates such as axiolid-core, axiolid-mesh, or axiolid-reference. Feature bundles are named for capability—not an input format:

axiolid = { git = "https://github.com/axiolid/kernel.git", features = ["discrete"] }

General NURBS algorithms are independently opt-in and also included in the broader parametric bundle:

axiolid = { git = "https://github.com/axiolid/kernel.git", default-features = false, features = ["nurbs"] }

See Getting started before selecting a bundle.

Architecture at a glance

format adapters / applications
              │ neutral values and operation requests
              ▼
      axiolid facade ─────────────── leaf representation crates
              │
      portable operation contracts
              │
       algorithms / providers
              │
              ▼
    dispatch and execution contexts

The central invariant is a downward-only dependency graph: representation does not know source formats or execution APIs; adapters do not depend on concrete backends. See Architecture.

What exists today

For precise limits and evidence, use the capabilities page, not this summary.

Development

cargo fmt --all -- --check
cargo test --workspace
cargo clippy --workspace --all-targets --all-features -- -D warnings
npm --prefix docs ci
npm --prefix docs run docs:build

The workspace also carries feature-isolation and mutation probes. See Contributing and HERMES.md for project-specific checks.

Project links

• Documentation
• Architecture decisions
• Capability status
• Roadmap
• Changelog
• Sponsor Axiolid
• Issue tracker

License

Axiolid is licensed under Mozilla Public License 2.0. Separate application files may remain proprietary; see the licensing guide.