2.9 KiB
| title | description |
|---|---|
| Installation – Agent Teams Docs | Download and install Agent Teams for macOS, Windows, or Linux. Covers packaged builds, source setup, auto-updates, and requirements. |
Installation
Agent Teams is distributed as a desktop app for macOS, Windows, and Linux.
Download builds
Use the download page or the latest GitHub release when you want the packaged app:
- macOS Apple Silicon:
.dmg - macOS Intel:
.dmg - Windows:
.exe - Linux:
.AppImage,.deb,.rpm, or.pacman
::: warning Windows SmartScreen Unsigned or newly published open-source apps can trigger SmartScreen. If you trust the release source, choose More info and then Run anyway. :::
Requirements
The packaged app is designed for zero-setup onboarding. It guides you through runtime detection and provider authentication from the UI — no manual CLI configuration needed.
To use agent runtimes, you need access to at least one provider:
| Provider | Access method |
|---|---|
| Claude (Anthropic) | Claude Code CLI login or API key |
| Codex (OpenAI) | Codex CLI login or API key |
| Gemini (Google) | Google ADC, Gemini CLI, or API key |
| OpenCode | API key for a supported backend (e.g. OpenRouter) |
::: info Gemini is available as a supported provider path. See Providers and runtimes for auth options and current status across all providers. :::
For source development, you also need:
| Tool | Version |
|---|---|
| Node.js | 20+ |
| pnpm | 10+ |
Run from source
git clone https://github.com/777genius/agent-teams-ai.git
cd agent-teams-ai
pnpm install
pnpm dev
The main branch carries the latest stable development. Switch to feature branches only if you need a specific unreleased change.
Auto-updates
The packaged app checks for updates automatically on launch and periodically while running. When an update is available, the app prompts you to download and install it. You can also check manually from the app menu.
::: tip
Auto-updates are not available when running from source. Pull the latest changes and rerun pnpm install when dependencies change.
:::
Updating from source
If you run from source, pull the main branch and rerun install when dependencies change:
git pull
pnpm install
Next steps
- Quickstart — from install to first running team
- Runtime setup — provider auth and model selection per runtime
- Create a team — recommended team shapes and brief writing