AgentOS Documentation¶

Local-first AI copilots that connect to your tools and run entirely on your machine.
Install in one command. Configure in the Web UI. Start asking questions.

Get Started Explore Copilots

Install¶

macOS / LinuxWindowsManual

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

# Michelle (Analytics)
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh -s -- --flavour michelle

# Brigitte (Management)
curl -fsSL https://unicolab.github.io/agentos/install.sh | sh -s -- --flavour brigitte

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

irm https://unicolab.github.io/agentos/install.ps1 | iex

# Download the binary for your platform
tar xzf agentos-pm_*.tar.gz
mv agentos-pm agentos

# macOS: clear Gatekeeper
xattr -rd com.apple.quarantine ./agentos
codesign --force --sign - ./agentos

# Run
./agentos serve

Open http://localhost:18080 after install.

License Required

AgentOS requires a license key. Email info@unicolab.ai for a free testing license.

Available Copilots¶

Each copilot is a specialized AI agent with its own persona, tools, and dashboard — all sharing the same engine.

🎩 Jean-Pierre

Project Management

• GitHub + Jira + Slack integration

• Living dashboard with risk scoring

• One-click executive reports

• Fleet view for multi-project portfolios

Learn more →

🔬 Michelle

Analytics Intelligence

• Connect databases, ask questions in plain English

• Auto-generated and validated SQL

• KPI engine with scheduling and alerts

• Schema auto-discovery and business glossary

Learn more →

Copilot	Install Flag	Domain
🧠 Brigitte	`--flavour brigitte`	Management coaching — leadership, team dynamics

Configure¶

After install, open the Web UI at http://localhost:18080 → Settings:

1. AI Provider¶

Provider	Type	Cost	Setup Guide
Ollama	Local (on your machine)	Free	Ollama Setup →
OpenAI	Cloud API	Per-token	Enter API key in Settings
Anthropic	Cloud API	Per-token	Enter API key in Settings
Google Gemini	Cloud API	Per-token	Enter API key in Settings

Recommended: Start with Ollama

Free, runs locally, and your data never leaves your machine. Install Ollama, pull a model, and configure AgentOS to use it.

2. Integrations¶

Integration	Copilot	Setup Guide
GitHub	Jean-Pierre	GitHub Setup →
Jira	Jean-Pierre	Jira Setup →
Slack	Jean-Pierre	Slack Setup →
Databases (PostgreSQL, MySQL, BigQuery, SQLite)	Michelle	Configure in Settings → Connections

3. License¶

Enter your license key in Settings → License. Need one? Email info@unicolab.ai.

Screenshots¶

🎩 Jean-Pierre

Living Dashboard

Fleet View

Sprint Forge

Team Pulse

🔬 Michelle

Analytics Dashboard

KPI Dashboard

AI Chat

Schema Browser

Privacy & Security¶

All data stays on your machine — conversations, memory, API keys, project data. Nothing is transmitted to UnicoLab except license validation.

Using Ollama? Zero cloud communication. Fully air-gap capable.

Full Security & Privacy Details →

Reference¶

Resource	Description
Installation Guide	Detailed install for all platforms
Quick Start	5-minute setup walkthrough
Configuration	All configuration options
CLI Commands	Command-line reference
API Endpoints	REST API documentation
Keyboard Shortcuts	UI shortcuts

Part of the AIFlow Ecosystem¶

AgentOS copilots work standalone but can optionally connect to the AIFlow platform for centralized portfolio intelligence across teams.