Getting Started

Versors machines are cloud VMs designed for running AI agents. Each machine is an isolated Linux environment with a desktop, terminal, browser, and persistent filesystem. Accessible from your browser on any device.

Machine Specs

Storage: 3, 5, 10, 20, or 50 GB persistent disk. 50 credits/GB/month, billed daily.

Machines turn off automatically after inactivity. Turn them back on in about 30 seconds. Everything persists, including files, installed packages, and agent sessions.

Pre-installed Stack

Runtimes: Node.js 22, Python 3.11, TypeScript, tsx, pnpm

Tools: git, Chrome + Puppeteer, FFmpeg, ImageMagick, Pandoc, Ghostscript, Tesseract OCR, ripgrep, jq, curl, SQLite3

Python: pandas, numpy, scipy, matplotlib, seaborn, beautifulsoup4, requests, Pillow, PyMuPDF, openpyxl, xlsxwriter, Flask, FastAPI

Global npm: http-server, json-server, TypeScript

Full sudo access. Install anything else with apt-get, pip, or npm.

Connecting Your Agent

The expected workflow: create a machine, open the terminal, and run your CLI agent.

# Claude Code (pre-installed)
claude

# Codex
codex

# Gemini CLI
gemini

# Any other CLI agent that runs on Linux

Authenticate directly with your provider. Your credentials stay on the machine and are never transmitted to Versors. See the Bring Your Own AI guide for details.

Built-in Agent

Every machine also comes with a built-in Versors agent accessible from the chat panel. It supports 8 models across 5 providers (2 free). Useful when you don't have a CLI agent subscription or want a quick chat interface.

All agents, built-in and BYO, have access to Versors tools (image/video generation, TTS, browser automation, app hosting). See Versors Tools for details.

See Models & Credits for the full model list and pricing.

Two Interfaces

Client-side desktop. The default view. A fast browser-native interface with file explorer, code editor, chat panel, terminal, app previews, and document/media viewers.

Remote Desktop. Opens the full Linux display (XFCE). This is the same display your agent drives via GhostPilot. Use it to watch browser automation, debug visual issues, or run desktop applications.

Key Concepts

• Machines are isolated VMs. Not containers. Each machine has its own filesystem, network, and process space.
• Everything persists. Files, packages, databases, running apps. All survive being turned off and back on.
• Credits are universal. One pool pays for compute, AI (built-in models), storage, and Versors tools.
• BYO agent billing is separate. When you run Claude Code or Codex, your provider bills you directly. Versors only charges for compute and storage.
• Context badges. Drag files or folders into the chat input to give the built-in agent context.