Grid

Grid is the Kubernetes control plane for multi-site AI routing with Praxis as the request data plane.

What Grid does

• Reconciles GridNetwork, GridSite, and provider CRDs.
• Forms site membership with SWIM and propagates provider state with CRDTs.
• Manages Grid trust material for mTLS between sites.
• Scrapes configured provider metrics and scores routing candidates.
• Renders Praxis routing overlay ConfigMaps consumed by gateway deployments.

What Grid does not do

Grid does not proxy model traffic, translate provider APIs, or run Praxis HTTP filters. Praxis handles request routing, filter execution, mTLS termination, credential handling, and backend proxying.

Getting started

# Validate the operator routing path in kind
cargo xtask env validate-operator-routing -c tests/env/operator-routing.toml

# Validate two-provider model routing in kind
cargo xtask env validate-operator-routing -c tests/env/operator-routing-two-provider.toml

# Validate SWIM membership in kind
cargo xtask env verify-swim-membership -c tests/env/operator-routing.toml

# Validate CRDT provider-state propagation over SWIM
cargo xtask env verify-swim-state -c tests/env/operator-routing.toml

Documentation

• Documentation index
• Architecture overview
• Custom resources
• Routing
• Scoring
• Auth and policy
• Operations

Development

• Development guide
• Conventions