GCP Computer Documentation

A unified, secure, lightning-fast sandboxing platform for AI coding agents. Provision isolated workspaces in milliseconds, allowing agents to execute shell commands, edit files, and mount host directories safely.

Lightning Fast

Provision sandboxes in milliseconds, not minutes.

Secure by Default

Isolated environments for every agent session.

GCP Native

Runs on Google Cloud Compute Engine.

Multiple Drivers

Docker, GCP VMs, or local emulation.

Agent-Ready

Built for AI agents with full tool execution.

Open Source

Built for the GDG Newport Beach Hackathon.

Quick Start

Get GCP Computer running locally in under 5 minutes:

Clone the repo and install dependencies with npm install
Copy .env.example to .env and set APP_MODE=local-emulated
Start the dev server with npm run dev
Open http://localhost:3000 and sign in

For detailed instructions, head to the Getting Started guide.

Architecture Overview

graph TD
    A[Next.js Frontend] -->|API & SSE| B[API Route Handlers]
    B -->|NextAuth / Postgres| C[(Postgres DB)]
    B -->|EVE Agent Core| D[Agent Tool Executor]
    D -->|Sandbox Manager| E[Sandbox Drivers]
    E -->|Docker| F[Docker Containers]
    E -->|GCP| G[Compute Engine VMs]
    E -->|Mock| H[Local Subprocesses]

Navigation

Getting Started →

Set up GCP Computer from scratch.

Installation →

Detailed install options and environment config.

Local Development →

Run with emulated sandboxes for offline demo.

Deployment →

Deploy to Google Cloud Platform.