@rivet-dev/agentos-eve

Use agentOS as the VM backend for Vercel Eve. Choose the deployed Rust agentOS actor or a standalone agentOS Core VM without coupling either hosting model to Eve.

Requires Node.js 24 or newer.

Rivet actor

pnpm add eve @rivet-dev/agentos @rivet-dev/agentos-eve

Connect to the fixed agentOS actor and optionally provide its creation config:

// agent/sandbox.ts
import { agentOSBackend } from "@rivet-dev/agentos-eve";
import { defineSandbox } from "eve/sandbox";

export default defineSandbox({
	backend: agentOSBackend({
		createInput: {
			config: {
				environment: { NODE_ENV: "production" },
			},
		},
	}),
});

Relative paths and command working directories resolve from /workspace. Configure persistence in the actor's filesystem config. Hosted configuration cannot mount host paths. The adapter never copies or interprets workspace data.

Each Eve session maps to a stable actor key. shutdown() stops processes opened through Eve and disconnects the client, but does not destroy the actor, so the session can reattach after actor sleep or process restart.

Advanced: standalone Core

Install Core instead of the actor package when Rivet orchestration is not needed:

pnpm add eve @rivet-dev/agentos-core @rivet-dev/agentos-eve

The factory creates one VM per Eve session. All VM configuration and filesystem persistence remain caller-owned:

import { AgentOs } from "@rivet-dev/agentos-core";
import { agentOSCoreBackend } from "@rivet-dev/agentos-eve";
import { defineSandbox } from "eve/sandbox";

export default defineSandbox({
	backend: agentOSCoreBackend({
		create: ({ sessionKey }) =>
			AgentOs.create({
				mounts: [
					{
						path: "/workspace",
						plugin: {
							id: "host_dir",
							config: {
								hostPath: `/var/lib/eve/${encodeURIComponent(sessionKey)}`,
							},
						},
						readOnly: false,
					},
				],
			}),
	}),
});

Standalone Core has no Rivet orchestration or automatic durable storage. shutdown() stops Eve processes and disposes the caller-created VM.

Network permissions belong to the actor creation config or the Core create() factory; Eve's runtime setNetworkPolicy() operation is unsupported.