Olympus

Add Olympus to your AI

Two steps. Install Olympus on your computer, then connect the AI you use. Your files stay on your computer; your AI asks Olympus.

Install Olympus on your computer

Olympus runs on a Mac with Apple silicon, or on x86_64 Linux with Omarchy or Ubuntu 24.04 LTS. No account to create.

By installing Olympus you agree to its Terms and acknowledge its Privacy Policy. Olympus is provided as is, without warranty. Keep your own backups.

On a Mac

Open Terminal (in Applications, then Utilities), paste this line, and press Return:

curl -fsSL https://olympusplugin.ai/install.sh | sh

On Omarchy

First install the tools Olympus uses to read scans, photos and voice notes:

sudo pacman -S --needed tesseract tesseract-data-eng poppler libvips libheif ffmpeg

Then, in a terminal:

curl -fsSL https://olympusplugin.ai/install-linux.sh | sh

On Ubuntu 24.04 LTS

On an x86_64 computer, install the prerequisites, then run the installer:

sudo apt install curl ca-certificates tar unzip coreutils findutils gawk grep diffutils procps util-linux systemd python3 tesseract-ocr tesseract-ocr-eng poppler-utils libvips-tools libheif1 ffmpeg
curl -fsSL https://olympusplugin.ai/install-linux.sh | sh

Other Linux distributions and ARM computers are not supported yet. Anonymous answers on Ubuntu need an administrator step; Olympus prints it when you run olympus zkapi check-confinement. Answers remain unavailable until the checks pass.

It takes a minute or two. When it says Olympus is installed and running (on Linux, Installed for your user without an administrator password), connect your AI. On Omarchy it also adds Olympus to your app launcher (Super+Space), which opens the dashboard. Running the same line again later updates Olympus, or repairs it if it stopped. You can read the installer before you run it: Mac, Linux.

On a server, or already using OpenClaw? Olympus runs there as an OpenClaw plugin. Install with OpenClaw.

Connect your AI

Connect your sources

Open the Olympus dashboard: in ChatGPT, ask Show my Olympus dashboard; on your computer, run olympus dashboard. Choose Connect next to Dropbox, Gmail or Google Drive and sign in with the accounts you already have. Pick which folders Olympus reads (Full, Names only or Skip), then Save and start. Other sources, such as X bookmarks or Readwise, are connected on your computer.

What the installer does

After that, Olympus downloads its built-in models in the background:

Nothing from your files leaves your computer during install.

Check that it is running

In a new Terminal window:

olympus engine status

Look for "ok": true. If something is missing, the missing list says what to do next. See also what to do when your AI says your computer is offline.

Where Olympus keeps things

On a Mac

FolderWhat is in it
~/Library/Application Support/OlympusThe Olympus app, the previous version, and the Bun runtime
~/.local/bin/olympusThe olympus command
~/Library/LaunchAgents/ai.olympusplugin.engine.plistThe login item that keeps Olympus running
~/.olympusOlympus settings and your privacy choices
~/.config/olympusSettings for Olympus's background worker
~/.local/share/openclaw/olympusYour index, the built-in models, and this computer's connection keys
~/Library/Logs/OlympusLogs, including install.log

On Linux

FolderWhat is in it
~/.local/share/olympus/engineOlympus, the previous version, and its runtime
~/.local/bin/olympusThe olympus command
~/.config/systemd/user/olympus-engine.serviceThe user service that keeps Olympus running
~/.config/olympusOlympus settings, and its keys in an encrypted file
~/.local/share/openclaw/olympusYour index, the built-in models, and this computer's connection keys (the folder name is historical; OpenClaw is not needed)

Uninstall

On a Mac, in Terminal:

curl -fsSL https://olympusplugin.ai/uninstall.sh | sh

On Linux:

curl -fsSL https://olympusplugin.ai/uninstall-linux.sh | sh

On a Mac, this stops Olympus, removes its login item, and deletes the app, the runtime, the olympus command and the line the installer added to your shell profile. On Linux, it stops Olympus and removes its service, the app and the olympus command. Both keep your data and settings, and list where they are. To only stop Olympus and remove its login item, keeping the app, run olympus engine uninstall instead.

To delete your data too, do this before uninstalling. It cannot be undone:

olympus engine stop
olympus data delete --all

Add --dry-run to the second line first to see what it will remove. To disconnect an AI app, remove Olympus in that app. See Your controls in the privacy policy for more.