Quickstart

pip / uv (local)

uv tool install tares      # or: pipx install tares
tares up                   # daemon + console on http://localhost:8787

Docker (compose)

The compose runs two containers from the same image: the daemon, and the MCP endpoint that agents connect to in the last step.

# docker-compose.yml
name: tares
services:
  taresd:
    image: ghcr.io/glassflow/tares:latest
    command: ["tares", "up", "--host", "0.0.0.0", "--data-dir", "/data"]
    ports: ["8787:8787"]
    volumes: [tares-data:/data]
  mcp:
    image: ghcr.io/glassflow/tares:latest
    command: ["tares", "mcp", "--transport", "streamable-http", "--host", "0.0.0.0",
              "--port", "8788", "--taresd", "http://taresd:8787"]
    ports: ["8788:8788"]
    depends_on: [taresd]
volumes:
  tares-data:

docker compose up -d         # daemon on :8787, MCP endpoint on :8788/mcp

(For a server with one hostname, TLS, and auth, see the full compose.)

Demo stack (fastest)

The demo is a self-contained stack (a small api-server, Prometheus, and a traffic generator) plus a catalog that wires up three correlated sources, a view, and two triggers. Two files, no checkout. Start the stack Tares will ingest from:

curl -O https://raw.githubusercontent.com/glassflow/tares/main/demo/docker-compose.yml
docker compose up -d

Stop the daemon from the first step (Ctrl-C) and restart it seeded with the demo catalog:

curl -O https://raw.githubusercontent.com/glassflow/tares/main/demo/catalog.demo.yaml
TARES_CATALOG=catalog.demo.yaml tares up

The startup log confirms the import: imported catalog.demo.yaml into catalog (3 sources, 1 views, 2 triggers).

Open Explore, pick the api-server entity, and watch metrics, logs, and alerts merge into one timeline. To break it on purpose and watch the triggers fire, see Run the demo stack.

(Prefer no catalog at all? Sources → Discover proposes sources from your running containers; the catalog just pre-wires the correlated view and the triggers.)

Your own source

In the console: Sources → Add source → github. Set:

• repo: glassflow/clickhouse-etl (or any public repo)

Save. Sources poll every 5 seconds by default, so commits appear within moments which are keyed by repo, with author as a label. The source page shows its Fields (per-field coverage) and recent events; Explore lets you browse the repos and authors and read their timelines.

Every connector works the same way; each connector page also shows an agent prompt that does this step for you.