Download Universe Bot

Current version 0.3.1. Free during the beta; model costs depend on the services you use.

Mac (Apple silicon or Intel)

  1. Download the version for your Mac. Not sure which one? Open About This Mac from the Apple menu: if it says Chip Apple M…, pick Apple silicon; if it says Processor Intel…, pick Intel.
  2. Open the dmg and drag Universe Bot into your Applications folder.
  3. Open Universe Bot from Applications. The Mac app is notarized by Apple, so the first time you open it macOS just reminds you it was downloaded from the internet. Click Open.
  4. macOS asks whether the app may use universe-bot Safe Storage in your keychain. Enter your Mac login password and click Always Allow. This key encrypts the API keys and passwords you save in the app.

Linux (x64, AppImage)

  1. Download the AppImage file.
  2. In your file manager, right-click it, open Properties → Permissions and tick Allow executing file as program. Or run chmod +x UniverseBot-*.AppImage in a terminal.
  3. Double-click to open it. If AppImageLauncher is installed, it first asks whether to add the app to your menu; either answer is fine.

Phone app (iPhone and iPad)

TestFlight beta
  1. Install Apple's TestFlight app on your iPhone or iPad.
  2. On your phone, tap the button below, then tap "Accept" and "Install".
  3. In Universe Bot on your computer, open Settings → "Phone app", turn on the phone connection and scan the QR code with the phone app.

The phone app is in a public TestFlight beta, free to join. It needs desktop version 0.3.0 or later, and your computer and Universe Bot need to be running. Messages are encrypted end to end and pass through the Universe Bot relay service, and we can't read them. Beta spots are limited; when they're full, the link stops accepting new testers for a while. Privacy

See what's new in this version

System requirements

Item Requirement
macOS macOS 13 or later; Apple silicon or Intel (Intel Macs from about 2017 on)
Linux x64 with a desktop environment that can run AppImages
Graphics Tested fine: Apple M3 (macOS 27). On very old graphics cards (tested: a 2012 NVIDIA GTX 660M), animations can make the graphics process restart now and then; the app keeps working. On Linux you can start it from a terminal with --force-prefers-reduced-motion to turn animations off
Encrypted storage The keychain on macOS; on Linux a system keyring such as GNOME Keyring. Without one, the app refuses to save API keys rather than storing them in plain text
Google Chrome Optional; only needed if agents should operate websites
Sandbox tools (Linux) Optional; bubblewrap and socat are needed for the read and write workspace level

AI tools to set up first (at least one)

Account you want to use Tool to install Install command Sign in
Claude subscription Claude Code curl -fsSL https://claude.ai/install.sh | bash Run claude in a terminal, then type /login
ChatGPT subscription Codex CLI npm install -g @openai/codex (needs Node.js) Click Sign in to ChatGPT on the app's start screen
Google account Gemini CLI npm install -g @google/gemini-cli (needs Node.js) Run gemini in a terminal and choose Login with Google
Your own API key Nothing to install — Enter it under the agent's Advanced settings → Model

No need to memorize any of this. The first time you open the app, the start screen checks what your computer is missing and gives you install commands you can copy.