Installation

Platform

Linux (x86_64 and aarch64). macOS support coming soon.

Install

Pick your preferred package manager:

# Python (pick one)
uv tool install agentbeacon        # recommended
pipx install agentbeacon
pip install --user agentbeacon

# npm
npm install -g agentbeacon

Then install agent SDK dependencies and start:

agentbeacon --setup          # install Claude + Copilot SDK dependencies
agentbeacon                  # start AgentBeacon
# Open http://localhost:9456

Set up PostgreSQL

AgentBeacon defaults to SQLite in your current directory, which is fine for trying things out. For anything beyond experimentation, set up PostgreSQL — see Storage.

Prerequisites

• Node.js 20+ — required for agent SDK dependencies
• At least one coding agent CLI installed:
  • Claude Code
  • Copilot CLI
  • Codex CLI
  • OpenCode (coming soon)
  • Any ACP-compatible agent
• An API key or subscription for the corresponding provider

AgentBeacon orchestrates coding agents you already have installed — it doesn’t bundle or replace them.

Build from Source

Note

Only needed if you want to develop or contribute. Most users should use the package install above.

git clone https://github.com/adrq/agentbeacon.git
cd agentbeacon
make all
make run
# Open http://localhost:9456

Requires Rust toolchain and Node.js 20+.

Port Configuration

Default port is 9456. Override with:

AGENTBEACON_PORT=9457 agentbeacon

Multiple instances can run simultaneously on different ports without conflicts.

Storage

AgentBeacon uses SQLite by default — no setup needed. For production deployments, PostgreSQL is recommended. See Storage for details.