Synnax

Synnax is an observability and control platform designed for high-performance hardware teams. Synnax aims to control the entire data lifecycle, from reading data from a sensor to writing bytes to a file, including a visualization engine and mechanisms for real-time propagation of data, allowing for the control of hardware. Synnax can be accessed both programatically through our client libraries and visually through our Console application.

Documentation

All official documentation can be found on our website. If you are interested in building on top of Synnax, please read our Contributing Guide and our technical documentation.

Development Status

Synnax is currently under active development. The APIs are stable and are unlikely to change significantly.

Releases follow semantic versioning. Versions with the same minor version number (e.g. 0.40.1 and 0.40.2) are guaranteed to maintain the same API, while releases with different minor version numbers (e.g. 0.40.0 and 0.41.0) may change APIs.

Our team is targeting a v1 release before the end of 2026, at which point all APIs will be considered stable and will not change until a v2 release.

Repository Organization

Synnax is built as a collection of several projects, all of which are collected in this monorepo. The following is a summary of each:

• Alamos - Dependency-injected code instrumentation that provides observability into the Synnax platform.
• Arc - A domain-specific language and compiler for hardware automation and control sequences, with a reactive execution model and a WebAssembly compilation target.
• Aspen - A gossip-based distributed key-value store used for propagating and persisting metadata between nodes, such as cluster topology, state, and configuration.
• Cesium - An embedded time series database engine optimized for high-performance reads and writes of time series sensor data.
• Client - Client libraries for communicating with the Synnax server in C++, Python, and TypeScript.
• Console - A data-visualization and graphical control application for macOS and Windows.
• Documentation Site - The code for the Synnax documentation website.
• Technical Documentation - Technical documentation such as RFCs and contribution guides.
• Drift - Redux state synchronization and declarative window management for building multi-window Tauri applications.
• Driver - An application that can connect to LabJack or National Instruments hardware or OPC UA servers and run control sequences on real-time operating systems.
• Freighter - A protocol-agnostic network transport for cross-language unary and streaming communication with implementations in several languages (C++, Go, Python, and TypeScript) and protocols (GRPC, HTTP, and WebSockets).
• Integration - A Python-based test conductor framework for end-to-end integration and stress testing across the Synnax server and its clients.
• Oracle - A schema definition language, code generator, and migration CLI used to keep Synnax's data models consistent across Go, TypeScript, Python, and C++.
• Pluto - A React component library for building modular user interfaces on top of the Synnax telemetry engine.
• Core - The core Synnax server, which integrates Aspen and Cesium to provide a unified telemetry system.
• X - Common utilities used by other projects.

Attributions

The Synnax server uses Pebble, and usage must follow their provided disclaimer.