Skip to main content

​
Quick install

The fastest way to install oobo is using the official install script.
Run the interactive installer:
curl -fsSL https://oobo.ai/install.sh | bash
The installer will:
  • Detect your platform automatically
  • Download the latest release
  • Install to ~/.oobo/bin/oobo
  • Add the binary to your PATH
  • Show you next steps
You may need to restart your shell or run source ~/.zshrc (or your shell’s rc file) for the PATH changes to take effect.

​
Platform support

Oobo supports the following platforms:
PlatformArchitectureC Library
macOSApple Silicon (aarch64)—
macOSIntel (x86_64)—
Linuxx86_64glibc
Linuxx86_64musl
LinuxARM64 (aarch64)glibc
LinuxARM64 (aarch64)musl
The installer automatically detects:
  • Your operating system
  • CPU architecture
  • C library variant (glibc vs musl for Linux)
Alpine Linux and other musl-based distributions are fully supported.

​
Environment variables

Customize the installation with environment variables:
​
OOBO_INSTALL_DIR
string
default:"~/.oobo/bin"
Override the installation directory
OOBO_INSTALL_DIR=/usr/local/bin curl -fsSL https://oobo.ai/install.sh | bash
​
OOBO_VERSION
string
default:"latest"
Install a specific version
OOBO_VERSION=v0.1.0 curl -fsSL https://oobo.ai/install.sh | bash
​
OOBO_NO_MODIFY_PATH
boolean
default:"0"
Skip automatic PATH modification
OOBO_NO_MODIFY_PATH=1 curl -fsSL https://oobo.ai/install.sh | bash
Use this if you prefer to manage your PATH manually.

​
Manual download

Prefer to download releases manually? Grab a binary from GitHub Releases.
1

Download the archive

Visit the releases page and download the archive matching your platform:
  • oobo-{version}-x86_64-apple-darwin.tar.gz (macOS Intel)
  • oobo-{version}-aarch64-apple-darwin.tar.gz (macOS Apple Silicon)
  • oobo-{version}-x86_64-unknown-linux-gnu.tar.gz (Linux x86_64 glibc)
  • oobo-{version}-x86_64-unknown-linux-musl.tar.gz (Linux x86_64 musl)
  • oobo-{version}-aarch64-unknown-linux-gnu.tar.gz (Linux ARM64 glibc)
  • oobo-{version}-aarch64-unknown-linux-musl.tar.gz (Linux ARM64 musl)
2

Extract the binary

tar -xzf oobo-*.tar.gz
This extracts the oobo binary.
3

Move to PATH

mkdir -p ~/.oobo/bin
mv oobo ~/.oobo/bin/
chmod +x ~/.oobo/bin/oobo
4

Add to PATH

Add to your shell’s rc file (~/.zshrc, ~/.bashrc, etc.):
export PATH="$HOME/.oobo/bin:$PATH"
Then restart your shell or source the file:
source ~/.zshrc

​
Build from source

Build oobo from source if you want the latest development version or need to modify the code.

​
Prerequisites

  • Rust toolchain (1.70 or later): Install Rust
  • Git: For cloning the repository

​
Build steps

1

Clone the repository

git clone https://github.com/ooboai/oobo.git
cd oobo
2

Build release binary

cargo build --release
This compiles oobo with full optimizations. The binary will be at:
target/release/oobo
The release build uses aggressive optimization settings (opt-level = "z", LTO, and stripping) to minimize binary size. Build time will be longer than debug builds.
3

Install the binary

Copy to a directory in your PATH:
mkdir -p ~/.oobo/bin
cp target/release/oobo ~/.oobo/bin/
Then add to your shell’s rc file:
export PATH="$HOME/.oobo/bin:$PATH"
4

Verify installation

oobo version
Should output version information.

​
Development build

For faster iteration during development: 
cargo build
./target/debug/oobo version
Debug builds are significantly larger and slower. Use release builds for production use.

​
Verify installation

After installation, verify that oobo is working correctly: 
oobo version
Expected output from oobo version: 
oobo 0.1.0 (https://oobo.ai)
git:  2.43.0
db:   /home/user/.oobo/oobo.db (not created)
os:   linux x86_64
The database won’t exist until you run oobo setup or make your first commit through oobo.

​
Uninstall

To completely remove oobo:
1

Remove the binary

rm ~/.oobo/bin/oobo
2

Remove data directory (optional)

This deletes all sessions, anchors, and configuration:
rm -rf ~/.oobo
This is irreversible. Back up any data you want to keep first.
3

Remove PATH entry

Edit your shell’s rc file (~/.zshrc, ~/.bashrc, etc.) and remove:
export PATH="$HOME/.oobo/bin:$PATH" # oobo
4

Remove git alias (if installed)

oobo alias uninstall
Or manually remove from your shell’s rc file:
alias git=oobo  # oobo
5

Remove agent skill (optional)

rm -rf ~/.agents/skills/oobo

​
Troubleshooting

The binary is installed, but your shell can’t find it. Try:
  1. Restart your terminal
  2. Source your shell’s rc file: source ~/.zshrc (or ~/.bashrc, etc.)
  3. Check if the directory is in your PATH: echo $PATH
  4. Manually add to PATH if missing: 
    export PATH="$HOME/.oobo/bin:$PATH"
The binary needs execute permissions:
chmod +x ~/.oobo/bin/oobo
Your platform may not be supported yet. Try:
  1. Check the releases page for available platforms
  2. Build from source if you have Rust installed
  3. Open an issue on GitHub to request support for your platform
The installer requires either curl or wget. Install one:Debian/Ubuntu:
sudo apt-get install curl
macOS:
brew install curl
Alpine:
apk add curl
Ensure you have:
  • Rust 1.70 or later: rustc --version
  • Updated toolchain: rustup update
If build still fails, check the error message and:

​
Next steps

Quick Start

Run the setup wizard and make your first commit

Configuration

Configure AI tools and endpoints

Build docs developers (and LLMs) love

Get started for freeTalk to us