isA OS Platform

Operating system services for AI agents - VMs, desktops, browsers, and code execution.

Overview

isA OS provides a unified platform for AI agents to interact with computing resources:

Service	Description	Port
Pool Manager	Unified resource gateway	8090
Cloud OS	VM management (Firecracker)	8001
Desktop Agent	Desktop remote control	-
Python REPL	Code execution sandbox	8001
Web Services	Web automation	8000

Latest Updates (2026-05-17)

Python REPL and Code REPL now expose streaming execution routes for long-running code output.
Cloud OS exposes WebSocket command streaming for VM execution.
Web Automation now registers as an A2A service for agent-driven browser work.
Pool Manager exports Prometheus metrics for active, warm, idle, max, healthy, utilization, and queue-depth resource state.

Architecture


┌─────────────────────────────────────────────────────────────────┐
│                    AGENTS & APPLICATIONS                         │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐              │
│  │  Agent  │ │   MCP   │ │ Python  │ │   Web   │              │
│  │  :8080  │ │  :8081  │ │  REPL   │ │Services │              │
│  └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘              │
└───────┴──────────┴──────────┴──────────┴──────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────────┐
│                      POOL MANAGER                                │
│                (Unified Resource Gateway)                        │
│                                                                  │
│  POST /pools/{type}/acquire  → Get resource                     │
│  POST /pools/{type}/{id}/execute → Run action                   │
│  DELETE /pools/{type}/{id}/release → Return resource            │
│                                                                  │
│  Pool Types: browser | vm | repl | device | desktop             │
└─────────────────────────────────────────────────────────────────┘
                           │
         ┌─────────────────┼─────────────────┐
         ▼                 ▼                 ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│    cloud_os     │ │   desktop_os    │ │    external     │
│   (Virtual)     │ │   (Physical)    │ │  (3rd Party)    │
│                 │ │                 │ │                 │
│ • Firecracker   │ │ • User desktops │ │ • E2B           │
│ • Docker        │ │ • 10 tools      │ │ • Browserbase   │
│ • Python REPL   │ │ • WebSocket     │ │ • Modal         │
│ • Browsers      │ │ • Heartbeat     │ │                 │
└─────────────────┘ └─────────────────┘ └─────────────────┘

Key Features

Pool Manager

Central gateway for acquiring and managing all resources.

Cloud OS

Virtual machine management using Firecracker microVMs:

Create/start/stop/delete VMs
Execute commands in VMs
File read/write operations
Resource limits (CPU, memory, disk)

Desktop Agent

Allow AI agents to interact with personal desktops:

10 built-in tools (file ops, bash, clipboard, screenshots)
WebSocket real-time connection
Visibility control (private, shared, friends, org)

Python REPL

Isolated Python code execution:

Multiple providers (E2B, Local, Docker)
Session state persistence
Fast execution (< 200ms with E2B)
Streaming execution via POST /execute/stream
Code REPL streaming via POST /api/v1/code-repl/execute/stream

Web Services

Web automation capabilities:

Web crawling (Markdown, HTML, structured data)
Web search (Brave API, AI summaries)
Deep search (multi-strategy, RAG)
Browser automation (LLM-driven)
A2A service registration for delegated web automation

Streaming Execution

Service	Route	Protocol
Python REPL	`POST /execute/stream`	HTTP streaming
Code REPL	`POST /api/v1/code-repl/execute/stream`	HTTP streaming
Cloud OS	`WS /api/v1/vms/{vm_id}/execute/stream`	WebSocket

Service Comparison

Feature	Cloud OS	Desktop Agent	Python REPL
Isolation	VM-level	Process-level	Sandbox
Persistence	Hours/days	Session	Minutes
Use Case	Full OS tasks	Desktop control	Code execution
Latency	~2s startup	Real-time	< 200ms

Getting Started

Quick Start - Basic setup
Pool Manager - Resource gateway
Cloud OS - VM management
Desktop Agent - Desktop control
Python REPL - Code execution
Web Automation - Web services

isA_MCP - MCP tool layer (API consumer)
isA_Agent - AI agent framework
isA_Cloud - Infrastructure layer (Go/gRPC)