RustKernels

GPU-accelerated kernel library for financial services, compliance, and enterprise analytics

Version 0.4.0 | RingKernel 0.4.2 | 106 kernels | 14 domains | 19 crates

Overview

RustKernels provides 106 GPU-accelerated algorithms across 14 domain-specific crates, engineered for financial services, regulatory compliance, and enterprise analytics workloads. Built on RingKernel 0.4.2, it delivers both CPU-orchestrated batch execution and GPU-persistent ring execution with sub-microsecond message latency.

Key Features

Execution Model

Kernels operate in one of two modes, selected based on latency and throughput requirements:

Batch kernels implementing BatchKernel<I, O> can be executed directly via typed calls or through the type-erased BatchKernelDyn interface used by REST and gRPC endpoints. Ring kernels require the RingKernel persistent actor runtime.

Domains at a Glance

Quick Start

Add to your Cargo.toml:

[dependencies]
rustkernels = "0.4.0"

Basic usage:

use rustkernels::prelude::*;
use rustkernels::graph::centrality::{BetweennessCentrality, BetweennessCentralityInput};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let kernel = BetweennessCentrality::new();
    println!("Kernel: {}", kernel.metadata().id);

    let input = BetweennessCentralityInput {
        num_nodes: 4,
        edges: vec![(0, 1), (1, 2), (2, 3), (0, 3)],
        normalized: true,
    };

    let result = kernel.execute(input).await?;
    for (node, score) in result.scores.iter().enumerate() {
        println!("  Node {}: {:.4}", node, score);
    }
    Ok(())
}

Feature Flags

# Default domains (graph, ml, compliance, temporal, risk)
rustkernels = "0.4.0"

# Selective compilation
rustkernels = { version = "0.4.0", features = ["graph", "accounting"] }

# All 14 domains
rustkernels = { version = "0.4.0", features = ["full"] }

# Service deployment
rustkernel-ecosystem = { version = "0.4.0", features = ["axum", "grpc"] }

Enterprise Features

Version 0.4.0 provides production-ready enterprise capabilities with deep RingKernel 0.4.2 integration:

See Enterprise Features for detailed documentation.

Requirements

• Rust 1.85 or later
• RingKernel 0.4.2 (from crates.io)
• CUDA toolkit (optional; falls back to CPU execution)

Project Structure

crates/
├── rustkernels/             # Facade crate — re-exports all domains
├── rustkernel-core/         # Core traits, registry, enterprise modules
│   ├── security/            # Auth, RBAC, multi-tenancy
│   ├── observability/       # Metrics, tracing, logging
│   ├── resilience/          # Circuit breaker, retry, health
│   ├── runtime/             # Lifecycle, configuration
│   ├── memory/              # Pooling, reductions
│   └── config/              # Production configuration
├── rustkernel-ecosystem/    # Service integrations (Axum, gRPC, Actix)
├── rustkernel-derive/       # Procedural macros
├── rustkernel-cli/          # Command-line interface
└── rustkernel-{domain}/     # 14 domain-specific crates

Building

# Build entire workspace
cargo build --workspace

# Run all tests (895 tests)
cargo test --workspace

# Test a single domain
cargo test --package rustkernel-graph

# Lint with warnings as errors
cargo clippy --all-targets --all-features -- -D warnings

# Generate API documentation
cargo doc --workspace --no-deps --open

License

Licensed under Apache-2.0. See LICENSE for details.