fluxrig

README

fluxrig

The specialized protocol patchbay for mission-critical orchestration.

fluxrig is a high-performance, open-source platform designed to route, transform, and simulate business data streams across any protocol.

Whether you are modernizing legacy payments (ISO8583), building IoT fleets (Protobuf), or orchestrating microservices (JSON), fluxrig provides a high-fidelity "Rig" to wire your systems together with sovereign precision.

Key Concepts

• Protocol Agnostic: Native support for ISO8583, JSON, XML, Protobuf, and raw binary.
• Hot-Path / Cold-Path Architecture: A stateless, low-latency Rack (Go/Wasm) for data processing and a stateful Mixer for fleet control.
• Smart Orchestration: Route traffic based on deep business payload inspection.
• Wasm Extensibility: Write custom logic in Go, Rust, or TypeScript without recompiling the core engine.
• Ops-Ready: Native OpenTelemetry (OTel) tracing, metrics, and hot-reload capabilities.

Getting Started

Prerequisites

• Go 1.25+
• Make
• GCC/Clang (Required for Mixer/DuckDB)

Build & Run

1. Build:

   make build
   

   Binaries will be placed in bin/.

2. Basic Usage:

   # Start the Mixer (Control Plane)
   ./bin/fluxrig-mixer
   
   # Start a Rack Agent
   ./bin/fluxrig agent start
   

Documentation

Full documentation, including architecture guides and Gear references, is available at fluxrig.org/docs.

Contributing

We welcome contributions! Please see our Contributing Guide and Code of Conduct.

Community

• Discussions: GitHub Discussions — Questions, ideas, announcements.
• Discord: Join our engineering community on Discord.

Acknowledgments

This project was developed with significant assistance from AI coding tools, including Antigravity (Google DeepMind), Claude (Anthropic), Gemini (Google), Cursor, and GitHub Copilot. See NOTICE for full details.

License

fluxrig is licensed under the Apache 2.0 License. See LICENSE for details.

Copyright (c) 2025-2026 JAAB Tech SAS, Uruguay.