convez.ai
AgenteDevOps & InfraestruturaAvançado
suhteevah

ClaudioOS

suhteevah/claudio-os

SO bare-metal em Rust para múltiplos agentes Claude com hardware nativo

Ver no GitHub
InicialPluginScore · de 0 a 100

Sistema operacional bare-metal em Rust construído especificamente para executar múltiplos agentes Claude simultaneamente sem kernel Linux ou POSIX. Oferece um dashboard tmux com panes independentes, cada um rodando uma sessão Claude com acesso a ferramentas de desenvolvimento (editor, Python, Rust, JavaScript) e drivers de hardware completos.

Instalação

$npx convez-ai suhteevah/claudio-os

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar múltiplos agentes Claude em paralelo com isolamento de tarefa
  • Desenvolvimento e prototipagem de sistemas multi-agent em hardware bare-metal
  • Pesquisa de arquitetura de SO focada em aplicações de IA com streaming SSE

Veredito

Projeto extremamente ambicioso e técnico: um SO completo em Rust (294k LOC) com drivers, suporte a múltiplas arquiteturas binárias e integração nativa com Claude. Prototípico e experimental — não para produção — mas fornece insights valiosos sobre otimização bare-metal para cargas de trabalho de IA paralelas.

README

A tradução para o português deste README ainda está na fila.

ClaudioOS -- Bare-Metal AI Agent OS

A bare-metal Rust operating system purpose-built for running multiple AI coding agents (Anthropic Claude) simultaneously. No Linux kernel, no POSIX, no JavaScript runtime -- just Rust, UEFI, and direct HTTPS to Claude.

52 crates. 56 kernel modules. 563 source files. 294,710 lines of Rust. 12 languages. 0 lines of C.

ClaudioOS boots your machine into a split-pane terminal dashboard where each pane is an independent Claude agent session with tool use (text editor, Python interpreter, Rust compiler, JavaScript evaluator). The entire stack -- from hardware interrupts to TLS 1.3 handshakes to SSE streaming -- is a single-address-space async Rust application.

GitHub: suhteevah/claudio-os Site: claudioos.vercel.app License: AGPL-3.0-or-later (Ridge Cell Repair LLC)


Feature Highlights

  • Multi-agent dashboard -- tmux-style split panes, each running an independent Claude session
  • 6 pane types -- Agent, Shell, Web Browser, File Manager, System Monitor, Screensaver
  • Windows binary compatibility -- PE loader + Win32 API layer + .NET CLR + WinRT, run Windows executables on bare metal
  • Vulkan + DirectX graphics -- Vulkan 1.3 driver + DXVK bridge (DirectX 9/10/11 to Vulkan translation)
  • Linux binary compatibility -- ELF loader + Linux syscall translation layer, run Linux binaries on bare metal
  • Native TLS 1.3 -- AES-128-GCM-SHA256 with hardware AES-NI, direct HTTPS to Claude APIs
  • SSE streaming -- real-time token-by-token streaming with backpressure, buffered rendering, rate limiting
  • Two auth modes -- claude.ai Max subscription (OAuth) or Anthropic API key
  • Model selection -- runtime model switching (Opus, Sonnet, Haiku) with per-agent configuration
  • Session auto-refresh -- JWT expiry detection, automatic token refresh before expiry
  • AI-native shell -- 45+ Unix-like builtins + natural language mode (type English, get commands)
  • Full filesystem stack -- ext4, btrfs, NTFS, FAT32, VFS layer, GPT/MBR partition detection
  • Vector store -- in-kernel vector database with cosine similarity search for agent memory and RAG
  • Agent memory -- persistent memory system with embeddings, semantic search, cross-session recall
  • Hardware drivers -- AHCI/SATA, NVMe, Intel NIC, WiFi, Bluetooth, USB storage, xHCI USB (keyboard + mouse + touchpad), HDA audio, NVIDIA GPU, SMP
  • WiFi networking -- Intel AX201/AX200 driver with WPA2/WPA3, network scanning, association
  • Bluetooth -- HCI/L2CAP/GAP/GATT stack over USB transport, HID device support
  • USB mass storage -- BOT (Bulk-Only Transport) + SCSI command set for thumb drives
  • ACPI hardware discovery -- MADT (CPU cores, I/O APICs), FADT (power management), HPET (precision timer), MCFG (PCIe ECAM)
  • SMP multi-core -- APIC-mode interrupt routing, AP core startup via SIPI, work-stealing scheduler
  • Post-quantum SSH -- ML-KEM-768 + X25519 hybrid KEX, ML-DSA-65 host keys, port 22
  • Inter-agent IPC -- message bus, named channels, shared memory, 8 IPC tools for Claude agents
  • 12 native languages -- Python, JavaScript, Rust (Cranelift JIT), Go, C++, Lua, TypeScript, JVM bytecode, WebAssembly, C, x86 assembly, plus nano-like editor
  • Git client -- native git clone, commit, push, pull, diff, log, branch, status over HTTPS
  • Email client -- SMTP send and IMAP receive, MIME parsing, in-kernel email composition
  • Text-mode browser -- HTML parser, CSS selectors, HTTP/HTTPS transport (wraith), link following
  • Image viewer -- in-terminal image rendering with dithering for framebuffer display
  • Full-text search -- in-kernel search across files, conversations, and agent output
  • File manager -- visual directory browser with copy, move, rename, delete, search
  • System monitor -- real-time CPU, memory, network, and agent stats dashboard
  • Conversation management -- list, select, rename, delete claude.ai conversations
  • NTP time sync -- network time protocol client for accurate wall clock synchronization
  • Notifications -- system-wide notification framework with priority levels and agent alerts
  • Firewall -- stateful packet filtering, allow/deny rules, port-based and IP-based filtering
  • Disk encryption -- LUKS-compatible encryption layer for persistent storage
  • Swap management -- virtual memory swap to disk, configurable swap partitions
  • Cron scheduler -- periodic task execution with crontab-style scheduling
  • Virtual consoles -- multiple independent terminal sessions, Ctrl+Alt+F1-F6 switching
  • Clipboard -- system-wide copy/paste buffer shared across panes
  • Power management -- ACPI S3/S5 suspend/resume, battery status monitoring
  • Touchpad support -- PS/2 and USB touchpad driver with gesture recognition
  • Network tools -- ping, wget, curl, netstat, ifconfig, dns, traceroute, nslookup
  • Man pages -- built-in manual pages for all commands
  • Init system -- fw_cfg config, hostname, log level, auto-mount, startup scripts
  • User accounts -- SHA-256 password auth, SSH public key auth, user database
  • RTC wall clock -- CMOS real-time clock for timestamps, uptime tracking
  • Color themes -- 9 built-in themes (solarized, monokai, dracula, nord, gruvbox, and more)
  • Boot splash -- ASCII art logo with 4-stage progress bar
  • Boot chime -- PC speaker C5-E5-G5 ascending triad
  • Screensaver -- 5 modes: starfield, matrix rain, bouncing logo, pipes, digital clock
  • Session persistence -- Conversations survive reboots via QEMU fw_cfg
  • Unicode support -- full UTF-8 rendering in terminal and editor

Architecture

+=====================================================================+
|  Agent Dashboard (tmux-style split panes)                           |
|  +--------+ +--------+ +--------+ +--------+ +--------+ +--------+ |
|  | Agent  | | Shell  | |Browser | |FileMgr | |SysMon  | |Screen- | |
|  | (Claude| | (45+   | |(wraith | |(visual | |(CPU/   | | saver  | |
|  |  tools)| |  cmds) | | + TLS) | | dirs)  | | mem)   | | (5x)   | |
|  +--------+ +--------+ +--------+ +--------+ +--------+ +--------+ |
+=====================================================================+
|  Shell (45+ builtins + AI) |  SSH Daemon (post-quantum, port 22)    |
+============================+========================================+
|  API Client (SSE) | Auth (OAuth/key) | Editor | 12 Languages (native)  |
|  Git Client | Email (SMTP/IMAP) | NTP | Notifications | Search     |
|  IPC (msg bus + channels)  | Conversations | Session Refresh        |
|  VectorDB + Agent Memory   | Model Select  | Streaming (backpres.) |
|  Firewall | Encryption | Swap | Cron | VConsoles | Clipboard        |
+=====================================================================+
|  Windows Compat (PE loader + Win32 + .NET CLR + WinRT)              |
|  Vulkan 1.3 + DXVK (DirectX 9/10/11 -> Vulkan translation)         |
+=====================================================================+
|  Linux Compat (ELF loader + syscall translation)                    |
+=====================================================================+
|  VFS: ext4 | btrfs | NTFS | FAT32 | GPT/MBR                       |
+=====================================================================+
|  TLS 1.3 (embedded-tls) | smoltcp TCP/IP (DHCP, DNS)               |
+=====================================================================+
|  VirtIO-net | Intel NIC | WiFi | AHCI | NVMe | xHCI | HDA | GPU   |
|  Bluetooth | USB Storage | Touchpad | SMP | ACPI | RTC | Speaker   |
+=====================================================================+
|  Init | Users | Themes | Splash | Screensaver | Power | ManPages   |
+=====================================================================+
|  Kernel: async executor, 48 MiB heap, GDT/IDT, APIC, PCI, PIT     |
+=====================================================================+
|  UEFI Boot (bootloader crate v0.11)                                 |
+=====================================================================+

Quick Start

Prerequisites

  • Rust nightly (auto-installed via rust-toolchain.toml)
  • QEMU with OVMF firmware
  • Windows: MSVC build tools for the image builder

Build and Run

# 1. Build the kernel (52 crates, 294k lines)
cargo build

# 2. Create bootable disk image
cargo run --manifest-path tools/image-builder/Cargo.toml -- \
    target/x86_64-unknown-none/debug/claudio-os

# 3. Run in QEMU (-cpu Haswell required for AES-NI / TLS 1.3)
qemu-system-x86_64 \
    -bios /usr/share/OVMF/OVMF_CODE.fd \
    -drive format=raw,file=target/x86_64-unknown-none/debug/claudio-os-uefi.img \
    -device virtio-net-pci,netdev=net0 \
    -netdev user,id=net0 \
    -serial stdio \
    -m 1G \
    -cpu Haswell

Windows: Use run.ps1 for one-click launch with session persistence.

With API Key

CLAUDIO_API_KEY=sk-ant-api03-xxx cargo build

See docs/BUILDING.md for full build instructions, platform-specific setup, and troubleshooting.


Documentation

DocumentDescription
ARCHITECTURE.mdFull system architecture, boot sequence, memory layout, crate graph
HARDWARE.mdHardware drivers: AHCI, NVMe, Intel NIC, WiFi, Bluetooth, USB storage, xHCI, HDA, GPU, SMP, ACPI, touchpad
NETWORKING.mdNetwork stack: VirtIO-net, smoltcp, TLS 1.3, HTTP, claude.ai API, SSH
FILESYSTEMS.mdVFS layer, ext4, btrfs, NTFS, FAT32, GPT/MBR
SHELL.mdAI-native shell: 45+ builtins, pipes, env vars, scripting, network tools, themes
AGENTS.mdMulti-agent system: auth modes, dashboard, tool loop, IPC, session management
BUILDING.mdBuild instructions, QEMU setup, run.ps1, troubleshooting
OPEN-SOURCE-CRATES.md35 published repos, 52 workspace crates with usage examples
ROADMAP.mdFeature roadmap and TODO list

Published Crates (35 repos, 52 workspace crates)

These crates are standalone #![no_std] libraries usable in any bare-metal or embedded Rust project:

CategoryCrates
Filesystemsext4-rw, btrfs-nostd, ntfs-rw, vfs-nostd
Storage driversahci-nostd, nvme-nostd, usb-storage-nostd
Network driversintel-nic-nostd, wifi-nostd, net-nostd
Wirelessbluetooth-nostd
USBxhci-nostd
Audiohda-nostd
Systemacpi-nostd, smp-nostd, gpu-compute-nostd, elf-loader-nostd, linux-compat-nostd
Windows compatpe-loader-nostd, win32-nostd, dotnet-clr-nostd, winrt-nostd
Graphicsvulkan-nostd, dxvk-bridge-nostd
Securitysshd-pqc (post-quantum SSH)
Languagespython-lite, js-lite, rustc-lite, go-lite, cpp-lite, lua-lite, ts-lite, jvm-lite, wasm-runtime, cc-lite, asm-x86
Toolseditor-nostd, shell-nostd, terminal-nostd, agent-nostd
Webwraith-dom, wraith-render, wraith-transport

See OPEN-SOURCE-CRATES.md for usage examples and API documentation.


All 52 Crates

CrateLinesDescription
kernel29,533Boot, hardware init, async executor, dashboard, 56 kernel modules
claudio-terminal2,930Framebuffer terminal, split panes, ANSI/VTE
claudio-net3,172VirtIO-net, smoltcp, TLS 1.3, HTTP/SSE
claudio-api1,849Anthropic Messages API, SSE streaming, tools
claudio-auth395OAuth device flow, API key, token refresh
claudio-agent501Agent session lifecycle, tool loop (20 rounds)
claudio-shell2,884AI-native shell, 45+ builtins, pipes
claudio-vfs2,871Virtual filesystem, mount table, POSIX API
claudio-ext43,013ext4: superblock, inodes, extent trees
claudio-btrfs4,006btrfs: B-trees, chunks, CRC32C, COW
claudio-ntfs3,561NTFS: MFT, data runs, B+ tree indexes
claudio-ahci2,139AHCI/SATA: HBA registers, sector I/O
claudio-nvme2,563NVMe: queue pairs, doorbell registers
claudio-intel-nic1,986Intel e1000/e1000e/igc: DMA rings, PHY
claudio-wifi3,513WiFi: Intel AX201/AX200, WPA2/WPA3, scanning
claudio-bluetooth3,075Bluetooth: HCI/L2CAP/GAP/GATT, USB transport, HID
claudio-usb-storage1,357USB mass storage: BOT protocol, SCSI commands
claudio-xhci4,204xHCI USB 3.0 + HID keyboard
claudio-acpi2,433ACPI: RSDP, MADT, FADT, MCFG, HPET
claudio-hda2,631HD Audio: CORB/RIRB, codec discovery, PCM
claudio-smp3,391SMP: APIC, trampoline, work-stealing scheduler
claudio-gpu3,392NVIDIA GPU: Falcon, FIFO, tensor ops
claudio-sshd4,191Post-quantum SSH: ML-KEM-768, ML-DSA-65
claudio-elf-loader1,213ELF binary loader: parsing, relocation, execution
claudio-linux-compat4,090Linux syscall translation layer for binary compat
claudio-editor534Nano-like text editor (11 tests)
python-lite2,388Python interpreter (28 tests)
js-lite5,229JavaScript evaluator
rustc-lite142Rust compiler via Cranelift
go-lite--Go interpreter: goroutines, channels, interfaces, structs
cpp-lite--C++ interpreter: classes, templates, RAII, STL subset
lua-lite--Lua interpreter: tables, metatables, coroutines
ts-lite--TypeScript interpreter: type checking, interfaces, generics
jvm-lite--JVM bytecode interpreter: class loading, GC, threads
wasm-runtime--WebAssembly runtime: validation, execution, WASI subset
cc-lite--C interpreter: pointers, structs, malloc/free, preprocessor
asm-x86--x86-64 assembler: Intel syntax, labels, relocations
wraith-dom2,070HTML parser, CSS selectors (32 tests)
wraith-render1,225HTML to text-mode renderer (12 tests)
wraith-transport572HTTP/HTTPS over smoltcp
claudio-pe-loader1,497PE/COFF binary loader: parsing, relocation, import resolution
claudio-win3210,458Win32 API compat: kernel32, user32, gdi32, DirectWrite, D2D, WASAPI, XInput, WIC
claudio-vulkan3,811Vulkan 1.3 driver: instance, device, swapchain, command buffers, shaders
claudio-dxvk-bridge2,039DirectX 9/10/11 to Vulkan translation layer (DXVK-style)
claudio-dotnet-clr5,179.NET Common Language Runtime: PE/CLI loader, IL interpreter, GC, BCL
claudio-winrt1,676Windows Runtime API projection: activation, metadata, async patterns
claudio-fs40FAT32 persistence (stubbed)
cranelift-*-nostd--4 forked Cranelift crates for no_std
rustc-hash-nostd--Forked rustc-hash for no_std
arbitrary-stub--no_std stub for arbitrary crate

Kernel Modules (56)

These are in-kernel modules under kernel/src/ that wire the standalone crates to the hardware and dashboard:

ModuleLinesDescription
git.rs2,120Native git client: clone, commit, push, pull, diff, log, branch, status over HTTPS
dashboard.rs2,024Main dashboard loop, pane management, input dispatch
agent_memory.rs1,849Persistent agent memory: embeddings, semantic search, cross-session recall
main.rs1,261Boot sequence, hardware init, async entry point
vectordb.rs1,062In-kernel vector database: cosine similarity, KNN search, RAG support
agent_loop.rs1,055Agent tool loop, SSE streaming, tool execution
email.rs967Email client: SMTP send, IMAP receive, MIME parsing, composition
screensaver.rs9515 modes: starfield, matrix rain, bouncing logo, pipes, digital clock
power.rs921ACPI S3/S5 suspend/resume, battery monitoring, power profiles
encryption.rs905LUKS-compatible disk encryption, key derivation, crypto layer
filemanager.rs843Visual file manager pane: directory listing, copy/move/rename/delete/search
firewall.rs788Stateful packet filtering, allow/deny rules, IP/port filtering
nettools.rs787ping, wget, curl, netstat, ifconfig, dns, traceroute, nslookup
ipc.rs783Message bus, named channels, shared memory, 8 IPC tools for agents
touchpad.rs734PS/2 and USB touchpad driver, gesture recognition
manpages.rs674Built-in manual pages for all commands
browser.rs659Text-mode web browser pane: wraith + smoltcp, URL bar, link following
ssh_server.rs568SSH listener on port 22, TCP session management, echo shell
acpi_init.rs523ACPI table discovery: MADT, FADT, HPET, MCFG parsing
conversations.rs517Conversation management: list, select, rename, delete via claude.ai API
init.rs505fw_cfg config loading, hostname, log level, auto-mount, startup scripts
swap.rs499Virtual memory swap to disk, configurable swap partitions
search.rs494Full-text search across files, conversations, and agent output
session_manager.rs487Session auto-refresh: JWT expiry parsing, automatic token refresh
intel_nic.rs454Intel NIC -> smoltcp Device adapter, full network stack with DHCP
users.rs440User database, SHA-256 password auth, SSH public key auth
image_viewer.rs413In-terminal image rendering with dithering for framebuffer display
cron.rs410Periodic task scheduler, crontab-style scheduling
mouse.rs402USB HID mouse state, XOR crosshair cursor, event queue
interrupts.rs387IDT setup, exception handlers, IRQ routing
ntp.rs383NTP client: network time sync, drift correction, accurate wall clock
vconsole.rs372Virtual consoles, Ctrl+Alt+F1-F6 switching
themes.rs3659 color themes with ANSI 24-bit escape generation
sysmon.rs306System monitor: CPU, memory, network, agent stats with ANSI rendering
win32_compat.rs175Windows binary compat: PE loading, Win32 API dispatch, DLL resolution
dotnet_compat.rs83.NET CLR integration: assembly loading, IL execution, managed/native interop
linux_compat.rs301Linux binary compat: syscall translation, /proc emulation, signal dispatch
notifications.rs300System-wide notification framework: priority levels, agent alerts, toasts
rtc.rs299CMOS RTC wall clock, BCD/binary decode, PIT-corrected uptime
executor.rs287Interrupt-driven async executor, hlt when idle
streaming.rs280SSE streaming: backpressure, buffered rendering, rate limiting
framebuffer.rs263GOP framebuffer init, double-buffered, dirty region tracking
model_select.rs255Runtime model switching: Opus, Sonnet, Haiku, per-agent config
pci.rs245PCI bus enumeration, BAR mapping, bus mastering
smp_init.rs233Multi-core boot: MADT-driven AP startup, APIC mode, legacy PIC disable
splash.rs214Boot splash: ASCII art logo, 4-stage progress bar
usb.rs186xHCI controller init, USB keyboard -> PS/2 scancode bridge
keyboard.rs180PS/2 keyboard decoder, scancode queue
memory.rs124Page table setup, physical memory offset
boot_sound.rs111PC speaker boot chime: C5-E5-G5 via PIT channel 2
clipboard.rs108System-wide copy/paste buffer shared across panes
serial.rs103UART 16550 serial output at 115200 baud
gdt.rs76GDT + TSS setup
logger.rs32Log framework: serial + framebuffer sinks
terminal.rs28Terminal crate bridge

Target Hardware

MachineCPUGPUNICStatus
QEMUHaswell (emulated)--VirtIO-netPrimary dev target
Desktopi9-11900KRTX 3070 TiI219-VPlanned
Supermicro SYS-4028GR-TRTDual Xeon8x GPU10GbEPlanned
HP Victus laptopi5-12500HRTX 3050Intel Wi-FiPlanned
Arch Linux box----Intel NICPlanned

License

  • ClaudioOS (kernel + integration): AGPL-3.0-or-later
  • Published crates (35 GitHub repos): MIT + Apache-2.0 dual license

Copyright (c) Ridge Cell Repair LLC


Support

If you find this project useful, consider supporting development:

Donate via PayPal

PayPal: baal_hosting@live.com




































































Support This Project

If you find this project useful, consider buying me a coffee! Your support helps me keep building and sharing open-source tools.

Donate via PayPal

PayPal: baal_hosting@live.com

Every donation, no matter how small, is greatly appreciated and motivates continued development. Thank you!

Ver o original no GitHub

Bom para

Relacionados