Skip to content
@AxonOS-org

AxonOS

A real-time Rust microkernel for safety-critical BCI. Deterministic EDF scheduling · Zero-copy signal path · Hardware-gated stimulation interlock.
AxonOS — open cognitive operating system for brain–computer interfaces

AxonOS

The open cognitive operating system for brain–computer interfaces.


🇬🇧 English · 🇯🇵 日本語 · 🇨🇳 中文 · 🇮🇹 Italiano · 🇫🇷 Français · 🇩🇪 Deutsch · 🇪🇸 Español · 🇸🇦 العربية


Standard Kernel Consent Protocol Rust License Verified


axonos.org  ·  Specifications  ·  SDK  ·  Research  ·  Articles  ·  connect@axonos.org


What AxonOS is

AxonOS is a hard real-time neural operating system for brain–computer interfaces. Open-source kernel in #![no_std] Rust on ARM Cortex-M. Formally bounded worst-case response time. Structural privacy that the application layer cannot bypass.

It is not an AI-agent framework, not a chatbot runtime, not a generic Python SDK, and not a token project. Everything below the application — the timing guarantees, the neural-permission model, the consent state machine — is specified, openly licensed, and built to be independently verified.

Applications should receive typed, consent-bound intent events — never unrestricted raw neural streams.


The four commitments

Commitment What it means in practice
1 Hard real-time on commodity hardware #![no_std] Rust on ARMv8-M. No GC, no allocator on the hot path, no unbounded panics. Memory safety is structural.
2 Formally bounded WCRT Every critical-path operation has a Kani-verified upper bound. Latency is proven, not benchmarked.
3 Structural privacy Capabilities that would leak raw cognitive state (RawEEG, EmotionState, CognitiveProfile) do not exist as types.
4 Open ecosystem Apache-2.0 OR MIT for code, CC-BY-SA-4.0 for specifications. Every repository is public. Anyone can audit, fork, or replace any layer.

Where to begin

Three honest paths, depending on what you want.

If you want to … Start here
A Get the idea in two minutes Concept video · 3-page engineering memo
B Read the engineering before judging axonos-standard/STANDARD.md · axonos-rfcs
C Build against the substrate axonos-sdk · SDK overview

The stack

Every repository is public. Source under Apache-2.0 OR MIT, specifications under CC-BY-SA-4.0. There are no private repositories. Each repository has one role.

Repository Role Language Latest
axonos-standard Normative architecture — the canonical technical standard Markdown
axonos-rfcs Design-change process — numbered engineering RFCs, normative once finalised Markdown active
axonos-kernel Execution substrate — hard real-time microkernel, formally bounded WCRT Rust
axonos-sdk Application boundary — typed intents, capability manifests, kernel ABI v1 Rust
axonos-sdk-python Application boundary (Python) — RFC-0006 wire format, byte-compatible with the Rust SDK Python
axonos-consent Consent / co-authorisation subsystem — #![no_std] reference crate Rust
axonos-protocol Network-level consent protocol — no_std, zero-alloc, bounded CBOR frames and an exhaustive consent state machine Rust
axonos-conformance Byte-exact conformance — RFC-0005 capability manifest & RFC-0006 intent wire format, cross-checked across Rust, Python, C, JavaScript, Java in CI multi active
axonos-validation Evidence and trace record — measurement traces and reference post-processing Python record
axon-bci-gateway Acquisition bridge — OpenBCI fork, MIT preserved from upstream HTML
axonos-swarm Long-horizon distributed timing — multi-node Neural PTP coordination Rust
AxonOS Public entry point — landing, concept, and links into the stack
become-the-brain-os Community front door — browser game that teaches the runtime, no install HTML/JS

The full path: electrode to intent

A complete brain–computer interface operating system is a continuous chain — from a raw electrode signal to a typed, consented intent, and back to a safe failure state. AxonOS is building that chain in the open. This map is deliberately honest about what is shipped, what is partial, and what is still ahead.

Stage Provided by Status
Electrode acquisition / ADC bridge axon-bci-gateway (OpenBCI) partial
Monotonic timestamping axonos-kernel live
Deterministic handoff — SPSC IPC, ring buffers axonos-kernel live
Signal conditioning / artifact rejection (DSP) dedicated DSP layer planned
On-device intent classification reference classifier planned
Typed intent ABI — RFC-0006 axonos-sdk, axonos-sdk-python live
Byte-exact conformance axonos-conformance live
Consent & capability gate — RFC-0005 axonos-consent, axonos-protocol, kernel gate live
Application boundary axonos-sdk live
Audit & reproducible traces axonos-validation live (L2 traces pending)
Safe failure state axonos-kernel live

What a complete BCI OS still needs

The execution core, the consent and capability layer, and the conformance surface are in place. To be a full operating system — not only a standard and a kernel — AxonOS still needs, and is sequencing on its roadmap:

  • a dedicated acquisition driver and a fixed-point DSP pipeline (signal → features), plus a reference on-device classifier;
  • a deterministic simulator, so a developer can run the full path without hardware;
  • a structured safety case (hazard analysis, FMEA, residual-risk argument) and a formal threat model for cognitive data — as engineering artifacts, not regulatory claims;
  • a privacy-vault enforcement layer that guarantees raw neural data never crosses the application boundary;
  • a public conformance program and an independent-implementer challenge, so a third party can build a compatible kernel and SDK from the specification alone;
  • a path from founder-led to foundation / technical-steering governance.

These are roadmap items, not present capabilities. They are published here so the distance between today's reference implementation and a complete, independently implementable BCI operating system is visible rather than hidden.


Architecture

flowchart LR
    A[EEG/EMG sensors<br/>ADS1299 · 24-bit] -->|raw| B[Acquisition gateway<br/>nRF52840]
    B -->|filtered| C[AxonOS kernel<br/>Rust no_std<br/>Cortex-M4F]
    C -->|WCRT ≤1000µs, proven| D[Cognitive scheduler]
    D -->|typed intent| E[Application<br/>via SDK]
    F[Cognitive Hypervisor<br/>TrustZone-S] -.->|isolates| C
    G[Consent FSM<br/>axonos-consent] -.->|gates| D

    classDef kernel fill:#0a4a8f,stroke:#0a4a8f,color:#fff,stroke-width:2px
    classDef secure fill:#0d7a5f,stroke:#0d7a5f,color:#fff,stroke-width:2px
    class C kernel
    class F,G secure
Loading

Every arrow is a contract. The Standard defines what must hold at each boundary; an implementation is free in everything else.


By the numbers


≤ 1000 µs

End-to-end WCRT, upper bound
L1 — machine-checked proof

≤ 0.5 µs

IPC slot latency, upper bound
L1 — machine-checked proof

≤ 1648 cyc

Consent-withdrawal bound
L1 — machine-checked proof

30+

Kani BMC harnesses
upper bounds proven

2

Audited `unsafe` operations (kernel)
`forbid(unsafe)` in consent & protocol

42+

Long-form architecture
articles on Medium

The evidence taxonomy — L1 formally proven, L2 measured on reference hardware, L3 independently validated — is defined in VALIDATION.md, and every claim is graded in CLAIMS.md. The bounds above are L1: machine-checked proofs, published and proof-linked. The corresponding L2 worst-case figures — end-to-end latency, jitter, and the resulting improvement over a general-purpose OS — come from internal long-duration soak testing. Until their raw traces are published in axonos-validation, no measured performance figure is claimed here; the figures are held as publication-pending and graded in CLAIMS.md. L3 independent reproduction is not claimed.


Quick start

git clone https://github.com/AxonOS-org/axonos-sdk
cd axonos-sdk
cargo test --features std
use axonos_sdk::{Capability, IntentStream, Manifest};

let manifest = Manifest::builder()
    .app_id("com.example.cursor")?
    .capability(Capability::Navigation)
    .max_rate_hz(50)
    .build()?;

let mut stream = IntentStream::connect(&manifest)?;
while let Some(obs) = stream.try_next()? {
    println!("{:?} @ {} µs ({}%)",
        obs.kind(),
        obs.timestamp().as_micros(),
        obs.confidence_percent());
}

The SDK is the Rust reference binding. C FFI, Python, WebAssembly, JNI, and Swift bindings are on the published roadmap.


Status

Phase What When
Phase 0 Architecture, RFCs, SDK API surface, kernel verification harnesses Complete
Phase 1 Clinical-grade 8-channel development kit · ALS centre pilot Q2 2026
Phase 2 FDA 510(k) Q-Sub for the Cognitive Hypervisor · IEEE P2731 contribution Q3 2026
Phase 3 First commercial deployment via Foundation members 2027

What AxonOS does not claim

AxonOS does not currently claim, and this organisation must not be read as claiming:

  • FDA clearance, CE marking, or medical-device approval in any jurisdiction;
  • clinical efficacy, or independent clinical validation;
  • certified medical-device status, or production-implant readiness;
  • complete compliance with IEC 62304, ISO 14971, or ISO 13485.

These are possible future milestones. They are not present facts, and the project records them as such.


Documentation


Contributing

Path Where
Bugs and feature requests the relevant repository's Issues tab
Specification proposals pull request to axonos-rfcs
Code contributions axonos-sdk/CONTRIBUTING.md
Security disclosures security@axonos.org · 90-day coordinated disclosure
Clinical partnerships connect@axonos.org
General correspondence connect@axonos.org

Licensing

Artefact License
Kernel, SDK, consent, swarm, gateway Apache-2.0 OR MIT
RFCs and specifications CC-BY-SA-4.0
axon-bci-gateway MIT (preserved from upstream OpenBCI_GUI)



AxonOS logo

The AxonOS Project

axonos.org  ·  connect@axonos.org  ·  LinkedIn  ·  Medium

Singapore · Zurich · Berlin · Milano · San Mateo


Built with Rust. Verified with Kani. Aimed at hard real-time.

Pinned Loading

  1. axonos-rfcs axonos-rfcs Public

    Proposals, design documents, and architectural decisions for the AxonOS project.

    2

  2. axonos-kernel axonos-kernel Public

    Hard real-time Rust microkernel for brain-computer interfaces. #![no_std] on Cortex-M, EDF scheduling with Kani-verified WCRT bounds, zero-copy intent path, capability-based privacy by construction…

    Rust 3

  3. axonos-standard axonos-standard Public

    Canonical technical standard and architecture manual for AxonOS: deterministic BCI software, neural permissions, consent, validation, and governance.

    Python 2

  4. axonos-consent axonos-consent Public

    Kernel-level consent state machine for brain–computer interfaces — no_std, zero-alloc, #![forbid(unsafe_code)], formally bounded (Kani), with optional guardian co-authorisation.

    Rust 3

  5. axonos-sdk-python axonos-sdk-python Public

    Python SDK for AxonOS — RFC-0006 intent wire format and capability model, byte-compatible with the Rust reference.

    Python 1

  6. axonos-conformance axonos-conformance Public

    Verified conformance vectors + multi-language codecs for AxonOS wire formats (RFC-0006, RFC-0005). Rust ≡ Python ≡ C ≡ JS ≡ Java, byte-identical.

    C 1

Repositories

Showing 10 of 16 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…