Stateless-yet-stateful infrastructure for distributed, horizontally-scalable web systems.
Geodineum is a modular ecosystem of independently-developed components that snap together into high-throughput, multi-tenant, distributed applications: a service mesh, a CMS substrate, a topology engine, a Rust template runtime, a notification daemon, depending on which pieces you assemble. Three load-bearing decisions hold it together: zero local state (any request can land on any worker), ValKey as the single source of truth (one data plane for PHP, Rust, and everything else), and typed interface contracts between every layer.
Geodineum is the installer and
orchestrator. One install.sh deploys the stack; every component declares its
wiring in a single geodeploy.yaml manifest and the orchestrator handles
deploy, ValKey ACL grants, systemd, logging, CLI, and backups.
git clone https://github.com/geodineum/Geodineum.git
cd Geodineum
sudo ./install.shMulti-node: several hosts share one ValKey brain over a private WireGuard VPN and discover each other's services geometrically. Joining a constellation is one flag-driven install.
| Component | What it is |
|---|---|
| Geodineum | Installer, geodineum operator CLI, and the manifest contract. The front door. |
| gNode | Rust daemon: geometric service discovery (capability vectors, O(1) spatial lookup), stream processing, Tera template rendering, signed extensions. ~23 MB RAM serves a whole host. |
| gNode-Client | Typed PHP client for gNode: ValKey streams, FCALL tiers, credential resolution. |
| gCore | PHP manager-of-managers framework with typed interface contracts; runs inside WordPress or standalone. |
| gCore-Contract | The contract layer: 10 typed premium-manager interfaces plus the base ModuleInterface. Stubs and Pro implementations both satisfy them; build your own against the same contracts. |
| gTemplate | WordPress parent theme: phased bootstrap, tiered rendering, a filter-hook contract any child geometry can implement. |
| gCube | Reference child theme: a CSS 3D cube with six faces as the site's navigation surface. |
| Geodineum-COMMS | Rust notification daemon: consumer-group reader from ValKey streams, dispatch via email / Telegram / SMS with backoff and archiving. |
| Geodineum-BAK | Backup and log-rotation infrastructure. |
| gMath | Q64.64 fixed-point arithmetic crate: bit-identical results on every node, no IEEE 754 jitter. |
| ValKey | The shared backend everything coordinates through (external project, open-source Redis fork). |
Every component is its own repo with its own version and manifest. Interface contracts decouple implementations: swap one in or out and no caller code changes. gNode extensions are Ed25519-signed by the project; operators choose whether unsigned extensions may load.
Check the ROADMAP to see what is on our plate and pick up work from there; we do not curate good-first-issues. Fork, build, open a pull request; we review every PR. Wire-contract changes can be proposed but face intense scrutiny.
Pre-launch, Chapter 1 stabilisation. The architecture is settled and backs production sites today; specific Pro packages and extensions are in active development.
MIT or Apache-2.0, at your option, across all components.