mirror of https://github.com/ruvnet/RuVector.git synced 2026-05-27 08:45:07 +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-launch

QEMU microVM launcher for RVF cognitive containers.

What It Does

rvf-launch boots an .rvf file as a standalone Linux microservice inside a QEMU microVM. It extracts the embedded kernel from KERNEL_SEG, launches QEMU with virtio I/O, and provides a programmatic API for lifecycle management.

Features

Feature	Description
Launcher	Full QEMU process management with automatic cleanup
KVM/TCG detection	Auto-selects KVM acceleration when available, falls back to TCG
QMP protocol	Real QEMU Machine Protocol client for graceful shutdown
Kernel extraction	Reads KERNEL_SEG from `.rvf` files for boot
Port forwarding	Automatic virtio-net with API and optional SSH ports

Usage

use rvf_launch::{Launcher, LaunchConfig};
use std::time::Duration;

let config = LaunchConfig {
    rvf_path: "appliance.rvf".into(),
    memory_mb: 128,
    vcpus: 2,
    api_port: 8080,
    ssh_port: Some(2222),
    enable_kvm: true,
    ..Default::default()
};

let mut vm = Launcher::launch(&config)?;
vm.wait_ready(Duration::from_secs(30))?;

// Query vectors through the VM
let results = vm.query(&query_vector, 10)?;

// Graceful shutdown via QMP
vm.shutdown()?;

Requirements

QEMU installed (qemu-system-x86_64 or qemu-system-aarch64)
KVM optional (falls back to TCG emulation)

Tests

cargo test -p rvf-launch  # 8 tests

License

MIT OR Apache-2.0