Installation
This document describes how to install Opair, and how to upgrade or uninstall it afterwards.
Platforms
Opair is actively maintained on macOS, and should work fine on Linux too. Windows is not supported because some of the file system code is POSIX-specific.
Homebrew
brew tap philbooth/opair
brew trust philbooth/opair
brew install --cask opair
The cask is signed and notarized, so installs cleanly on macOS.
To upgrade later:
brew upgrade opair
Note that upgrading will overwrite
the asset directories (loops/, mcp/, prompts/, tools/)
in your config directory,
but config.json is not touched.
If you've customised the assets,
back them up somewhere else before upgrading
and then restore them after.
See the configuration docs
for more information.
To uninstall:
brew uninstall opair
Note the config directory is not removed by uninstallation.
Debian
AMD/Intel:
sudo apt install https://www.opairdev.org/downloads/opair_linux_amd64.deb
ARM (including Apple silicon):
sudo apt install https://www.opairdev.org/downloads/opair_linux_arm64.deb
If you're unsure of your architecture,
uname -m prints x86_64 for amd64 machines and aarch64 for arm64.
Earlier releases and checksums can be found on GitLab.
To upgrade you can run the same apt install command again,
it always points at the latest release.
Note that upgrading will overwrite
the asset directories (loops/, mcp/, prompts/, tools/)
in your config directory,
but config.json is not touched.
If you've customised the assets,
back them up somewhere else before upgrading
and then restore them after.
See the configuration docs
for more information.
To uninstall:
sudo apt remove opair
Note the config directory is not removed by uninstallation.
Red Hat
AMD/Intel:
sudo dnf install https://www.opairdev.org/downloads/opair_linux_amd64.rpm
ARM (including Apple silicon):
sudo dnf install https://www.opairdev.org/downloads/opair_linux_arm64.rpm
If you're unsure of your architecture,
uname -m prints x86_64 for amd64 machines and aarch64 for arm64.
Earlier releases and checksums can be found on GitLab.
To upgrade you can run the same dnf install command again,
it always points at the latest release.
Note that upgrading will overwrite
the asset directories (loops/, mcp/, prompts/, tools/)
in your config directory,
but config.json is not touched.
If you've customised the assets,
back them up somewhere else before upgrading
and then restore them after.
See the configuration docs
for more information.
To uninstall:
sudo dnf remove opair
Note the config directory is not removed by uninstallation.
Install from source
You need Go 1.27 or later and a local clone of the repository:
git clone https://gitlab.com/philbooth/opair.git
cd opair
There are some install scripts in the repo
that build and install with go install,
then set up your config directory
for the appropriate model provider:
# Anthropic setup:
scripts/install-anthropic.sh
# OpenAI setup:
scripts/install-openai.sh
# Mistral setup:
scripts/install-mistral.sh
# Deepseek setup:
scripts/install-deepseek.sh
# Z.ai setup:
scripts/install-zai.sh
# llama.cpp setup (local inference):
scripts/install-llamacpp.sh
# Enablers setup (internal platform for employees of Algolia):
scripts/install-algolia.sh
To upgrade,
you can git pull
and then re-run the scripts above.
Note that upgrading will overwrite
the asset directories (loops/, mcp/, prompts/, tools/)
and your config.json.
If you've customised the assets,
back them up somewhere else before upgrading
and then restore them after.
See the configuration docs
for more information.
To uninstall:
go clean -i ./cmd/opair
You'll need to remove the config directory manually.
After install
Opair must be configured before first use. See the configuration docs for more information.