agentos
Tiny, fast, Linux-compatible sandboxes. Powered by WebAssembly.
What is agentos?
Tiny, fast, Linux-compatible sandboxes. Powered by WebAssembly.
Overview of agentos
What it is
agentOS is a library for creating tiny, fast, Linux-compatible sandboxes powered by WebAssembly and V8 isolates. It provides each agent with files, processes, shell, and networking in one lightweight OS. It can be used as a library inside your backend process or as a hosted service on Rivet Cloud or self-hosted infrastructure.
Key features
- Library, not extra infrastructure: Installed from npm and runs inside the backend process you already operate.
- WebAssembly + V8, not a microVM: V8 isolates run JavaScript while WebAssembly contains compiled tools inside the same compact runtime.
- Direct function calls, not extra APIs: Connect agents to your application with ordinary JavaScript calls instead of another network service.
- Scoped access, not exposed credentials: Bind trusted host functions without ever giving the agent your raw secrets.
- One process, not a VM per agent: Many isolated agent operating systems share one compact runtime instead of duplicating a full microVM stack.
- Runs anywhere, no nested virtualization: Deploy on standard Linux infrastructure without a hypervisor or nested virtualization.
Use cases
agentOS is designed for running untrusted code, AI agents, or any workload that needs a lightweight, isolated Linux environment with files, processes, shell, and networking. It can be used for sandboxing, code execution, and agent-based applications.
Getting started
To use agentOS as a library, install the core package:bashnpm install @rivet-dev/agentos-coreThen create and use a VM:tsimport { AgentOs } from '@rivet-dev/agentos-core';const vm = await AgentOs.create();try { const result = await vm.process.exec('echo hello && ls /home/agentos', { output: { capture: 'all' } }); console.log(result.stdout);} finally { await vm.dispose();}For the hosted version, install the client:bashnpm install @rivet-dev/agentosSee the repository README for full configuration and hosted setup instructions.
License and pricing
The license is Apache-2.0. The pricing type is open source.
Based on the project's public README and repository metadata.