Skip to content
@geodineum

Geodineum

One man's journey to build for builders.

Geodineum

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.

Start here

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.sh

Multi-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.

Components

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.

Contributing

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.

Status

Pre-launch, Chapter 1 stabilisation. The architecture is settled and backs production sites today; specific Pro packages and extensions are in active development.

License

MIT or Apache-2.0, at your option, across all components.

Popular repositories Loading

  1. gNode gNode Public

    The central nervous system and node of the Geodineum Constellation

    Rust 2

  2. gCore gCore Public

    Build Geodineum-powered apps, services, websites with its official PHP framework

    PHP 1

  3. gNode-Client gNode-Client Public

    PHP client lib of gNode

    PHP 1

  4. gCube gCube Public

    gCube, childtheme of gTemplate. Geodineum-powered. CSS 3d Cube

    PHP

  5. Geodineum-COMMS Geodineum-COMMS Public

    The Geodineum notification and comms hub - it listens and then informs as instructed

    Rust

  6. gCore-Contract gCore-Contract Public

    The contract used by gCore pro and enterprise plugins (ch2)

    PHP

Repositories

Showing 10 of 11 repositories

Top languages

Loading…

Most used topics

Loading…