fluxrig
fluxrig is a high-performance orchestration engine and high-fidelity control plane for mission-critical distributed infrastructure and protocol orchestration.
It acts as a specialized patchbay that harmonizes connectivity across heterogeneous environments—from orchestrating industrial sensor signals to routing financial transactions, transforming complex technical debt into a standardized, configuration-driven signal flow. Primary use cases include IoT, Payment, and Industrial sectors, though the engine remains inherently protocol-agnostic.
TIP
New to the rig? Follow the Foundation Components guide to understand our core architectural pillars and specialized nomenclature.
Why fluxrig?
Integrating the physical world with the digital ecosystem is notoriously difficult. fluxrig solves this by treating all data like an audio signal passing through a professional studio mixing console.
- Zero-dependency agility: A single, lightweight Go binary (
<50MB). Deploy it on distributed edge nodes or high-capacity clusters in the cloud. No JVM, no complex dependencies. - Configuration over code: Route, transform, and buffer signals using declarative YAML configurations. Bring new systems online in minutes.
- Mission-critical resilience: Powered by NATS JetStream, fluxrig guarantees message delivery even during backhaul outages.
The studio philosophy: why "rig" and "Mixer"?
fluxrig borrows its architecture from the world of professional audio engineering:
- The Gear: Like a guitar effects pedal, a Gear is a specialized module that creates, modifies, or routes a signal (e.g., ISO8583 codec, Serial adapter).
- The Rack: Gears are chained together inside a Rack (the edge node) to form a complete signal processing chain.
- The Mixer: Just as instruments connect to a studio desk, all distributed racks connect to the central Mixer (control plane) for management and telemetry.
High-Fidelity Architecture
Key entities
| Entity | Definition | Analogy |
|---|---|---|
| Mixer | The central control plane and entity registry. | Studio Mixing Console. |
| Rack | An localized edge node executing the processing logic. | Equipment Rack. |
| Gear | A modular unit of logic (Native/Wasm). | Functional Effect Pedal. |
| Wire | An ordered, unidirectional persistent queue. | Signal Path / Patch Cable. |
| Snake | The secure, multiplexed link between Rack and Mixer. | Multi-core Audio Snake. |
| fluxMsg | The universal data structure for all internal signals. | Normalized High-Fi Signal. |
Choose your journey
For Operators & SREs
Maintain maximum uptime and operational visibility. fluxrig provides the tools to orchestrate distributed racks, manage immutable snapshots, and analyze high-fidelity telemetry in real-time.
- Deployment architecture & binaries →
- Operations & CLI reference →
- Technical configuration (Mixer/Rack) →
- Telemetry & analytics guide →
For Developers & SDK Users
Build specialized processing logic with minimal overhead. Leverage the Native Go SDK to create custom protocol drivers or use the declarative Bento Gear for high-speed message transformation.
- Writing your first Native Gear →
- SDK reference & contract →
- Bento Gear declarative logic →
- Gears ecosystem reference →
For Architects & Security Teams
Design resilient, sovereign data planes. fluxrig allows for the design of complex, multi-actor topologies that enforce strict data isolation, zero-trust connectivity, and deterministic execution.
- System foundation & core principles →
- Security & identity architecture →
- Network & message flow integrity →
- Industry use case spectrums →
