AirsSys is a collection of system programming components designed to facilitate the development of applications within the AirsStack ecosystem. It provides essential tools and libraries for managing system resources, handling low-level operations, and ensuring efficient performance.

Airssys is one of the airsstack projects, which is designed to manage the OS system programming, Erlang Actor Model runtime system, and pluggable system.

This project contains four important components:

• airssys-osl
• airssys-rt
• airssys-wasm
• airssys-wasm-component

AirsSys is a comprehensive collection of system programming components designed for the AirsStack ecosystem. It provides secure, modular, and high-performance tools for building robust concurrent applications with strong security guarantees.

View Complete Documentation →

The unified documentation covers all completed AirsSys components including architecture, guides, API references, and examples.

This project contains multiple specialized components:

• airssys-osl - OS Layer Framework (✅ Complete)
• airssys-rt - Actor Runtime System (✅ Complete)

• airssys-wasm - WASM Component Framework (⏳ In Development)
• airssys-wasm-cli - WASM CLI Tools (⏳ In Development)
• airssys-osl-macros - OSL Procedural Macros (⏳ In Development)
• airssys-wasm-component - WASM Component Macros (⏳ In Development)

use airssys_osl::helpers::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Secure file operations with built-in ACL/RBAC
    let data = b"Hello, World!".to_vec();
    write_file("/tmp/test.txt", data, "admin").await?;
    let content = read_file("/tmp/test.txt", "admin").await?;
    Ok(())
}

use airssys_rt::prelude::*;
use async_trait::async_trait;

#[derive(Debug, Clone)]
enum CounterMsg { Increment }

impl Message for CounterMsg {
    const MESSAGE_TYPE: &'static str = "counter";
}

struct CounterActor { count: u64 }

#[async_trait]
impl Actor for CounterActor {
    type Message = CounterMsg;
    type Error = std::io::Error;
    
    async fn handle_message<B: MessageBroker<Self::Message>>(
        &mut self,
        msg: Self::Message,
        _ctx: &mut ActorContext<Self::Message, B>,
    ) -> Result<(), Self::Error> {
        self.count += 1;
        Ok(())
    }
}

• Getting Started - Installation and first steps
• Components - Detailed component documentation
  • OSL Documentation
  • RT Documentation
• Guides - Integration, security, performance
• Examples - Practical usage examples
• Research - Design decisions and analysis

Secure, cross-platform abstraction over operating system functionality with comprehensive audit trails and security policy enforcement.

Key Features:

• Cross-platform OS abstractions (filesystem, process, network)
• Built-in ACL and RBAC security policies
• Comprehensive activity logging and audit trails
• Middleware pipeline for extensibility
• Helper functions for common operations

View OSL Documentation →

Lightweight Erlang-Actor model runtime for high-concurrency applications with BEAM-inspired supervision and fault tolerance.

Key Features:

• Zero-cost actor abstractions with compile-time type safety
• BEAM-inspired supervision trees (OneForOne, OneForAll, RestForOne)
• High performance: ~625ns actor spawn, 4.7M msgs/sec throughput
• Broker-based message routing with backpressure control
• Comprehensive monitoring and observability

View RT Documentation →

WebAssembly Component Framework for pluggable systems (⏳ In Development).

Note: WASM components are under active development. See individual mdbook documentation in airssys-wasm/docs/ for current status.

• airssys-osl-macros - Procedural macros for OSL custom executors
• airssys-wasm-cli - CLI tools for WASM component management
• airssys-wasm-component - Procedural macros for WASM development

# Run all tests
cargo test --workspace

# Run component tests
cargo test --package airssys-osl
cargo test --package airssys-rt

# Run with features
cargo test --features macros

# OSL examples
cargo run --example helper_functions_comprehensive
cargo run --example security_middleware_comprehensive

# RT examples
cargo run --example actor_basic
cargo run --example supervisor_basic
cargo run --example osl_integration_example

# Build unified MkDocs documentation
cd site-mkdocs
mkdocs serve  # Local preview at http://localhost:8000

# Build API documentation
cargo doc --open --workspace

See Contributing Guide for development guidelines.

• Documentation: https://airsstack.github.io/airssys/
• Repository: https://github.com/airsstack/airssys
• Issues: https://github.com/airsstack/airssys/issues

AirsSys is dual-licensed under:

• Apache License 2.0
• MIT License

You may choose either license at your option.

Current Version: 0.1.0
Documentation: https://airsstack.github.io/airssys/
Last Updated: December 2025