mirror of https://github.com/ruvnet/RuVector.git synced 2026-05-25 15:03:46 +00:00

History

rUv 161f890ddb fix: apply cargo fmt across workspace and fix CI issues - Run cargo fmt --all to fix formatting in 362 files across the entire workspace - Add PGDG repository for PostgreSQL 17 in CI test-all-features and benchmark jobs - Add missing rvf dependency crates to standalone Dockerfile for domain-expansion - Add sona-learning and domain-expansion features to standalone Dockerfile build - Create npu.rs stub for ruvector-sparse-inference (fixes rustfmt resolution error) Co-Authored-By: claude-flow <ruv@ruv.net>		2026-02-21 20:56:38 +00:00
..
src	fix: apply cargo fmt across workspace and fix CI issues	2026-02-21 20:56:38 +00:00
Cargo.toml	chore: bump rvf-types/rvf-crypto/rvf-runtime to 0.2.0 for new features	2026-02-16 14:04:23 +00:00
README.md	feat(rvf): RuVector Format — Universal Cognitive Container SDK (#166 )	2026-02-14 13:14:49 -05:00

README.md

rvf-kernel

Real Linux microkernel builder for RVF cognitive containers.

What It Does

rvf-kernel builds production-grade Linux kernel images and initramfs archives for embedding into .rvf files. A single .rvf file with KERNEL_SEG boots as a standalone Linux microservice on QEMU, Firecracker, or bare metal.

Features

Feature	Description
KernelBuilder	Builds bzImage from source via Docker, or loads prebuilt images
Initramfs builder	Real cpio/newc format archives with gzip compression
Docker pipeline	Reproducible kernel compilation with Linux 6.8.x config
SHA3-256 verification	Cryptographic hash verification of kernel artifacts
KernelVerifier	Extract and verify kernels from KERNEL_SEG

Usage

use rvf_kernel::KernelBuilder;
use rvf_types::kernel::KernelArch;

// Option 1: Load a prebuilt kernel
let kernel = KernelBuilder::from_prebuilt("bzImage")?;

// Option 2: Build in Docker (reproducible)
let builder = KernelBuilder::new(KernelArch::X86_64)
    .kernel_version("6.8.12")
    .with_initramfs(&["sshd", "rvf-server"]);
let kernel = builder.build_docker(&context_dir)?;

// Option 3: Build just the initramfs
let initramfs = builder.build_initramfs(
    &["sshd", "rvf-server"],
    &[("rvf-server", &binary_bytes)],
)?;

Kernel Config Highlights

VirtIO PCI/BLK/NET for VM I/O
BPF + JIT for eBPF programs
KASLR + stack protector for security
No modules, USB, DRM, or wireless (minimal attack surface)
~1.5 MB bzImage, ~512 KB initramfs

Tests

cargo test -p rvf-kernel  # 37 tests

License

MIT OR Apache-2.0