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
- A Mac with Apple silicon (M1 or later), on macOS 13 Ventura or later. Macs with an Intel processor are not supported.
Open Terminal (in Applications, then Utilities), paste this line, and press Return:
curl -fsSL https://olympusplugin.ai/install.sh | sh
On Omarchy
- Omarchy (Arch Linux) on an x86_64 computer. Omarchy already has everything else Olympus needs (a processor with SSE4.2, glibc 2.17 or later, systemd, and curl, tar and unzip).
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
- ChatGPTApprove it once, on your computer
- ClaudeWeb, desktop and phone
- GrokOn grok.com
- Grok BotUses your Grok connection
- DotsOpenAI's always-on agent
- Claude CodeOn this computer
- CodexOn this computer
- OpenClawNative plugin, Mac or Linux
- HermesLocal MCP server
- Any MCP appOn this computer
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
- Installs Olympus for your user only. It changes nothing outside your home folder.
- Downloads Olympus over a secure connection, with the runtime it needs, and checks each download against a published checksum before using it. If one does not match, it stops and changes nothing.
- Starts Olympus in the background, so it keeps running, and checks that it really started. On a Mac that is a per-user login item (a LaunchAgent). On Linux it is a systemd user service that keeps running after you log out; if your system needs an administrator to allow that, the installer stops before changing anything and prints the one command to run (
sudo loginctl enable-lingerand your user name). - Adds the
olympuscommand, and on a Mac a line to your shell profile so Terminal finds it. On Omarchy it also adds Olympus to the app launcher. - If an update does not start, puts the previous version back.
After that, Olympus downloads its built-in models in the background:
- A model used to search your items on your computer (EmbeddingGemma 2).
- A private answer model that stays on your computer: about 1.3 GB on a computer with 8 GB of memory, about 2.7 GB with 16 GB or more. It downloads only while the disk has room for it plus 2 GB to spare.
- A model that transcribes voice notes on your computer.
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
| Folder | What is in it |
|---|---|
~/Library/Application Support/Olympus | The Olympus app, the previous version, and the Bun runtime |
~/.local/bin/olympus | The olympus command |
~/Library/LaunchAgents/ai.olympusplugin.engine.plist | The login item that keeps Olympus running |
~/.olympus | Olympus settings and your privacy choices |
~/.config/olympus | Settings for Olympus's background worker |
~/.local/share/openclaw/olympus | Your index, the built-in models, and this computer's connection keys |
~/Library/Logs/Olympus | Logs, including install.log |
On Linux
| Folder | What is in it |
|---|---|
~/.local/share/olympus/engine | Olympus, the previous version, and its runtime |
~/.local/bin/olympus | The olympus command |
~/.config/systemd/user/olympus-engine.service | The user service that keeps Olympus running |
~/.config/olympus | Olympus settings, and its keys in an encrypted file |
~/.local/share/openclaw/olympus | Your 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.