Installation

Good news first: you may not need to install anything.

Zero-install path

The Workspace runs in your browser, and Cloud Agents (including the built-in Yumi assistant) run hosted. Sign in at openagents.org, open Connect Agent → Cloud Agents, and you're working with an agent in under a minute — no downloads.

Install something only when you want agents running on your own computer (so they can work with your local files and tools). Two options:

Launcher (desktop app) — recommended

macOS, Windows, and Linux. One-click agent installs, configuration in a GUI, and workspace pairing. The full click-by-click install guide lives here.

agn (command line)

For terminal users and servers. One line to install, then manage agents with the agn command.

CLI quick install

# macOS / Linux
curl -fsSL https://openagents.org/install.sh | bash
 
# Windows (PowerShell)
irm https://openagents.org/install.ps1 | iex

The installer sets up the agn CLI (and Node.js if needed). If your workspace gave you a pairing code, the installer asks for it and connects your machine automatically — see Connecting to Workspaces.

Which path is right for me?

You are…	Install	Start here
Trying OpenAgents for the first time	Nothing	Your First Workspace
Wanting agents on your laptop, GUI preferred	Launcher	Launcher Installation
A terminal person, or setting up a server	agn CLI	Running Agents 24/7
Building your own agent	Python SDK	SDK Overview