Skip to content

Getting Started

Agate runs as a single container that you place in front of your existing AG-UI agent. Your frontend connects to Agate instead of to the agent directly; Agate inspects, decides, records, and forwards.

flowchart LR
    fe["Frontend"] -->|AG-UI| agate["agate-server<br/>(container)"]
    agate -->|forwarded| agent["Your agent<br/>(agent_endpoint)"]
    agate --> pg[("Postgres")]

This section covers:

  1. Installation (Docker) — pull/build the image, set the handful of environment variables, point it at your agent, and run it.
  2. Configuration — the environment variables Agate reads today, and the file-based agate.toml configuration that is being designed.

Status

Agate is in early development (0.1.0). The data-plane proxy, the audit transparency log, and a first policy (tool allow/deny + secret redaction) are in place. A published Docker image and the agate.toml config file are still being finalized — see the notes on each page.