Skip to content

🛠️ Installation

Getting AgentOS running on your machine takes one command.

Download Latest Release Quick Start Guide

The fastest way to get started on macOS or Linux. This script auto-detects your OS and architecture, downloads the correct binary, and installs it to your PATH:

# Default: installs Jean-Pierre (PM copilot)
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh

# Choose a different flavour:
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh -s -- --flavour michelle
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh -s -- --flavour brigitte

# Install all agents at once:
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh -s -- --flavour all

Available Flavours

Flavour Description
pm (default) Jean-Pierre — AI Project Management Copilot
jean-pierre Alias for pm
michelle Michelle — Analytics Intelligence Copilot
brigitte Brigitte — Management Intelligence Copilot
all Install all three agents at once

That's it! After installation, run agentos-pm serve (or agentos-michelle, agentos-brigitte) and you're live. 🎉 Each agent installs as a separate binary for safe multi-agent coexistence.

🏗️ Supported Platforms

All architectures are pre-built and available on the Releases Page.

Each flavour has its own archive. Choose the one that matches your role:

Flavour Platform Archive Pattern
🎩 PM macOS arm64 / amd64, Linux, Windows agentos-pm_{version}_{os}_{arch}.tar.gz
📊 Michelle macOS arm64 / amd64, Linux, Windows agentos-michelle_{version}_{os}_{arch}.tar.gz
🧠 Brigitte macOS arm64 / amd64, Linux, Windows agentos-brigitte_{version}_{os}_{arch}.tar.gz

Not sure which macOS version?

Run uname -m in Terminal. arm64 = Apple Silicon, x86_64 = Intel.

Per-flavour binary names

Each agent installs as agentos-<flavour> (e.g. agentos-pm, agentos-michelle). This allows multiple agents to run side-by-side. A fleet manager agentos command is also installed for managing all agents.

🖥️ Manual Install

If you prefer to install manually:

# 1. Extract
tar xzf agentos_*_darwin_*.tar.gz

# 2. Move to PATH
sudo mv agentos /usr/local/bin/

# 3. Clear quarantine + sign
xattr -rd com.apple.quarantine /usr/local/bin/agentos
codesign --force --sign - /usr/local/bin/agentos

# 4. Verify
agentos version

No admin access? No problem — run it from any folder:

# 1. Extract
tar xzf agentos_*_darwin_*.tar.gz

# 2. Clear quarantine (no sudo needed on your own files)
xattr -rd com.apple.quarantine ./agentos
codesign --force --sign - ./agentos

# 3. Run directly
./agentos serve

Optional: add to your user PATH

mkdir -p ~/.local/bin
mv agentos ~/.local/bin/
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

macOS Gatekeeper

If you still see a security warning, go to System Settings → Privacy & Security and click "Allow Anyway" next to the AgentOS entry.

# 1. Extract
tar xzf agentos_*_linux_*.tar.gz

# 2. Move to PATH
sudo mv agentos /usr/local/bin/
sudo chmod +x /usr/local/bin/agentos

# 3. Verify
agentos version

Automatic (recommended):

# Download and run the installer (default: PM flavour)
irm https://unicolab.github.io/agentos/install.ps1 | iex

Manual:

  1. Download the .zip for your flavour from the Releases Page
  2. Extract the archive
  3. Rename the binary: ren agentos-pm.exe agentos.exe
  4. (Optional) Move to a folder in your system Path
  5. Open PowerShell and run: 
    .\agentos.exe serve

⚙️ Initial Configuration

Once AgentOS is running, navigate to http://localhost:18080. All configuration can be done directly in the Web UI Settings panel (++cmd+comma++).

CLI Setup is Optional

You can also run agentos setup for terminal-based configuration, but the Web UI provides the same functionality with a premium visual interface.

What you'll need:

  • 🤖 AI Provider: Ollama (free, local) or an API key (OpenAI, Anthropic, Gemini).
  • 🐙 GitHub Token: For repository tracking (optional).
  • 🔑 License Key: Request a free beta key at info@unicolab.ai.

🔋 Background Service

Run AgentOS automatically on boot:

agentos serve --install-service

Next: Quick Start Guide →