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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/rivet-devagentos.svg)](https://yunodb.com/tools/rivet-devagentos?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/rivet-devagentos?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/rivet-devagentos.svg" alt="Featured on YunoDB" height="20"></a>