Installation

Prerequisites

  • tmux (required)
  • Docker (optional, for sandboxing agents in containers)
  • Node.js (optional, only for building the web dashboard with --features serve)

Install Agent of Empires

Run the install script:

curl -fsSL \
  https://raw.githubusercontent.com/njbrake/agent-of-empires/main/scripts/install.sh \
  | bash

Homebrew

brew install aoe

Note: The Homebrew formula does not yet include the web dashboard (aoe serve) since the feature is still experimental. To use the web dashboard, install via the quick install script or build from source with --features serve.

Build from Source

git clone https://github.com/njbrake/agent-of-empires
cd agent-of-empires
cargo build --release

The binary will be at target/release/aoe.

To include the web dashboard (browser access):

cargo build --release --features serve

This requires Node.js and npm. The web frontend is built automatically during compilation.

Verify Installation

aoe --version

Uninstall

To remove Agent of Empires:

aoe uninstall

This will guide you through removing the binary, configuration, and tmux settings.