Home

OSAI Wiki

Purpose

This wiki is the canonical detailed design and implementation guide for OSAI. The main repository README.md is the short entry point; the wiki holds the architecture, platform plans, benchmarking strategy, roadmap, and Codex build tasks.

OSAI is a design-stage server-only operating system for CPU-only AI app agents. It targets applications that embed local AI agents capable of understanding their own source code, accepting human instructions, generating patches, rebuilding, testing, syncing with Git, and improving the running application.

Target Benefits

These are design targets until measured against tuned Linux/BSD baselines.

Area	Target
TCP/UDP latency	Up to 10-45% lower latency
Effective CPU-AI memory bandwidth	3-18% higher
Sustained usable CPU-core performance	2-12% higher
Scheduler jitter/migration	Near-zero on hot AI paths

OSAI cannot exceed physical silicon limits. The expected gains come from reducing scheduler migration, context switching, page faults after warmup, generic network overhead, memory duplication, bad NUMA placement, and unrelated interrupts.

Implementation Order

1. QEMU on macOS
2. Intel Desktop Port
3. Intel Xeon Port
4. ARM/NVIDIA Port

Start Here

• Project Purpose
• Architecture
• AI Cells
• Implementation Plan
• Codex Work Packages
• Testing and Benchmarking
• Performance Targets
• Roadmap
• Glossary
• FAQ

Architecture Pages

• AI Cells
• CPU AI Runtime
• App Agents
• Memory System
• Networking
• Scheduler and Core Isolation
• Filesystem and Storage
• Driver Model
• Security Model
• Build System

Platform Pages

• QEMU on macOS
• Intel Desktop Port
• Intel Xeon Port
• ARM/NVIDIA Port