Installation¶

This guide covers installing Brat and its dependencies.

Prerequisites¶

• Rust toolchain (1.75 or later)
• Git (2.30 or later)

Install Grite¶

Brat is built on Grite, an append-only event log. Install Grite first:

cargo install --git https://github.com/neul-labs/grite grite

Verify the installation:

grite --version

Install Brat¶

Option 1: One-Line Install (Recommended)¶

curl -fsSL https://raw.githubusercontent.com/neul-labs/brat/main/install.sh | bash

Option 2: From Source¶

Clone and build:

git clone https://github.com/neul-labs/brat
cd brat
cargo install --path crates/brat

Option 3: Cargo Install¶

cargo install brat

Verify Installation¶

Check that both tools are installed:

grite --version
brat --version

Install an AI Engine¶

Brat orchestrates AI coding tools. Install at least one:

# Install via npm
npm install -g @anthropic-ai/claude-code

# Or via homebrew
brew install claude-code

pip install aider-chat

npm install -g @openai/codex

cargo install opencode

Web UI (Optional)¶

To use the web dashboard, install the UI dependencies:

cd brat/brat-ui
npm install

Start the UI with:

npm run dev

The dashboard will be available at http://localhost:5173.

Next Steps¶

Now that Brat is installed, continue to the Quickstart guide.