Forging performance through parallelism and precision — in C++ and Rust.
Ferric Continuum is a multi-language systems playground built with Bazel. It focuses on side-by-side C++/Rust examples, clear teaching artifacts, and a Python/C++ optimizer prototype.
The repo name nods to a line in Use of Weapons about Minds blurring the boundary between tactics and strategy:
“The Minds did not assume such distinctions; to them, there was no cut-off between the two. Tactics cohered into strategy, strategy disintegrated into tactics, in the sliding scale of their dialectical moral algebra.”
In that spirit, this codebase blends C++, Rust, and Python so tensor work can flow across the stack without hard cutoffs between systems-level kernels, safe concurrency, and high-level orchestration.
- Collocated C++ and Rust examples in
ferric_continuum/helloandferric_continuum/foundation. - Foundation modules covering value semantics, move semantics, parameter passing, smart pointers/RAII, and constructor rules.
- Muon optimizer prototype in
ferric_continuum/optimizers/muonusing a C++ backend exposed to Python via pybind11. - Bazel-first workflows for builds, tests, and demos.
# Build everything
bazel build //...
# Run all tests
bazel test //...bazel run //ferric_continuum/hello:hello_cc
bazel run //ferric_continuum/hello:hello_rsbazel run //ferric_continuum/foundation:value_semantics_demo_cc
bazel run //ferric_continuum/foundation:value_semantics_demo_rs
bazel run //ferric_continuum/foundation:move_semantics_demo_cc
bazel run //ferric_continuum/foundation:move_semantics_demo_rs
bazel run //ferric_continuum/foundation:parameter_passing_demo_cc
bazel run //ferric_continuum/foundation:parameter_passing_demo_rs
bazel run //ferric_continuum/foundation:smart_pointers_demo_cc
bazel run //ferric_continuum/foundation:smart_pointers_demo_rs
bazel run //ferric_continuum/foundation:constructor_rules_demo_cc# Run the demo
bazel run //ferric_continuum/optimizers/muon:muon_demo
# Run the Python test
bazel test //ferric_continuum/optimizers/muon:muon_py_testferric_continuum/
├── hello/ # C++/Rust hello world example
├── foundation/ # Core C++/Rust concepts with demos and tests
└── optimizers/muon/ # Muon optimizer (pybind11 + numpy)
AGENTS.md- Agent roadmap and design notes (planned system)CXX_ENGINEERING.md- C++ engineering fundamentals (short guide)ENGINEERING.md- Coding standards and tooling guidanceferric_continuum/hello/README.md- Hello world walkthroughferric_continuum/foundation/README.md- Foundation module deep dive
This project is licensed under the MIT License - see the LICENSE file for details.
Ferric Continuum — Forging performance through parallelism and precision.