DOCUMENTATION

Getting Started

Versors gives you a personal cloud computer with an AI agent that can write code, create files, browse the web, and build real working software -all from plain English descriptions.

The Desktop

Your machine has a desktop interface with windows you can move, resize, and minimize -just like a real computer.

  • Desktop -Browse, create, rename, and delete files and folders
  • App Viewer -Live preview of running web apps with hot reload
  • Document Viewer -Open PDFs, Word docs (.docx), Excel spreadsheets (.xlsx), CSVs, and markdown files
  • Media Player -View images, play audio and video files
  • Markdown Editor -Rich text editor for documents and notes
  • Start Menu -Launch installed apps or create new ones
  • Code Editor -Full syntax-highlighted editor for any programming language
Versors desktop environment overview

What is a Machine?

A machine is your personal cloud computer. Each machine has its own desktop, file system, and AI agent. It runs Linux, has persistent storage, and comes pre-installed with Node.js, Python, Chrome, and common development tools. Everything you create -files, apps, projects -stays on your machine between sessions.

You can create multiple machines to keep projects separate. The number of machines you can run depends on your plan -Free gets 1, Creator gets 5, and Pro gets 20.

Your machine hibernates after 10 minutes of inactivity to save resources. When you come back, it resumes in a few seconds with everything exactly as you left it.

Creating Your First Machine

1

Sign up -Create an account with Google, GitHub, or email. You get 500 free credits to start.

2

Create a machine -Click "Create Machine" on the dashboard. It takes about 30 seconds to provision.

3

Open your desktop -Click on your machine to enter the desktop. You'll see a menu bar and a Versors Agent icon.

4

Add files and create -Drag and drop files onto the desktop, use the upload button in the menu bar, or talk to the Versors Agent and it will start creating files for you. Everything appears on the desktop as icons.

5

Use your machine -Double-click on any file to open it or any app to start it. Right-click and select download to save anything to your own computer. Keep working on your machine as long as your project needs. It works on all devices with a browser, including mobile.

Your First Conversation

1

Open the agent -Double-click the Versors Agent icon on your desktop to open the chat panel.

2

Start a conversation -Click "New" to start a fresh conversation, or select a past one to continue where you left off.

3

Talk to your AI -Describe what you want in plain English and the agent will execute it on your machine.

Key Concepts

Conversations

Each conversation is a separate thread with its own context. Start a new conversation for a new task, or continue an existing one to iterate. Your conversation history is saved and searchable.

Context badges

Drag files, folders, or apps from your desktop into the chat input to give the agent extra context. This helps it understand what you're working on without you having to explain.

Models

You can switch between AI models using the dropdown in the chat panel. Different models have different strengths and costs. See the Choosing a Model guide for details.

Credits

Every AI action costs credits. You get free daily credits plus your plan's monthly allocation. Simple tasks cost 0-4 credits; complex multi-step tasks cost more. Check your balance in the billing page.