@theaiinc/realm-container

Docker-based container engine for Realm.

Provides isolated Linux sandboxes with full lifecycle management, filesystem access, network control, and command execution — all behind the universal Realm API.

Features

• Container lifecycle — Create, start, stop, destroy containers via Docker
• Command execution — Run arbitrary commands inside containers
• Filesystem operations — Import/export files via tar streams
• Network control — Restrict, disable, or allow full internet access
• Screenshot capture — Capture container display output
• TypeScript-first — Full type safety with the RealmEngine interface

Installation

pnpm add @theaiinc/realm-container

Usage

import { ContainerEngine } from '@theaiinc/realm-container';

const engine = new ContainerEngine();
const session = await engine.create({
  image: 'ubuntu:24.04',
  networkMode: 'isolated',
});
await engine.exec(session.id, 'echo "hello from realm"');

Dependencies

• dockerode — Docker Engine API client

License

MIT