How agiresearch/aios works
AIOS is an agent operating-system kernel: an agent submits work, the kernel represents it as syscalls, schedules and dispatches those requests to resource managers, and returns results. The principal resource stages are LLM inference, memory, storage, and tools; context injection and configuration support those stages. The README also describes a computer-use extension with a VM controller and MCP server. Several links reflect documented architecture or SOURCE INDEX references; unsampled implementations are not asserted in detail.
Main entry points: fifo_scheduler.py Request scheduler · manager.py Memory manager · adapter.py LLM adapter · modules Resource hooks
Components 20
Kernel orchestration
- Syscall executor
aios/syscall/syscall.py - Request scheduler
aios/scheduler/fifo_scheduler.py - Resource hooks
aios/hooks/modules - Configuration
aios/config/config_manager.py - Terminal interface
aios/terminal/intent_router.py
LLM and context
- Context manager
aios/context/simple_context.py - LLM adapter
aios/llm_core/adapter.py - Model routing
aios/llm_core/routing.py
Memory management
- Memory manager
aios/memory/manager.py - Context injection
aios/memory/context_injector.py - Write barrier
aios/memory/write_barrier.py - Memory notes
aios/memory/note.py
Storage and tools
- Storage manager
aios/storage/storage.py - Semantic filesystem
aios/storage/filesystem/lsfs.py - Tool manager
aios/tool/manager.py
Computer use
- MCP server
aios/tool/mcp_server.py - VM controller
aios/tool/virtual_env/controllers - VM providers
aios/tool/virtual_env/providers/base.py - Desktop environment
aios/tool/virtual_env/desktop_env.py
Other components
- Agent client
Connections 24
- Agent client → Syscall executor: submits requests
README.md - Syscall executor → Request scheduler: schedules syscalls
README.md - Request scheduler → Resource hooks: dispatches requests
aios/scheduler/fifo_scheduler.py - Resource hooks → Memory manager: routes memory
aios/hooks/modules/memory.py - Resource hooks → Storage manager: routes storage
aios/hooks/modules/storage.py - Resource hooks → LLM adapter: routes LLM
aios/hooks/modules/llm.py - Request scheduler → LLM adapter: dispatches inference
aios/scheduler/fifo_scheduler.py - Request scheduler → Memory manager: dispatches memory
aios/scheduler/fifo_scheduler.py - Request scheduler → Storage manager: dispatches storage
aios/scheduler/fifo_scheduler.py - Request scheduler → Tool manager: dispatches tools
aios/scheduler/fifo_scheduler.py - LLM adapter → Model routing: selects model
aios/llm_core/adapter.py - LLM adapter → Context manager: uses context
aios/llm_core/adapter.py - Context injection → Memory manager: retrieves memories
aios/memory/context_injector.py - Memory manager → Write barrier: coordinates writes
aios/memory/manager.py - Memory manager → Memory notes: handles notes
aios/memory/manager.py - Storage manager → Semantic filesystem: delegates requests
aios/storage/storage.py - Tool manager → Configuration: loads server path
aios/tool/manager.py - Tool manager → MCP server: starts process
aios/tool/manager.py - VM controller → VM providers: uses providers
- VM controller → Desktop environment: controls desktop
- Tool manager → VM controller: computer-use extension
README.md - Terminal interface → Syscall executor: submits work
- Configuration → LLM adapter: configures models
aios/llm_core/adapter.py - Configuration → Memory manager: configures providers
aios/memory/manager.py