Skip to content
AgentTx

Installation

Build prerequisites, running from source, Docker, and working on the monorepo.

1 min readSynced from mainUpdated Sep 15, 2026

Prerequisites

RequirementVersionWhy
Rust1.88 or newerThe crate uses edition 2024
C++17 compilerGCC 11+ or Clang 14+RocksDB is compiled from source
libclangany recentbindgen generates the RocksDB bindings
Node.js + pnpm22.12+ / 11+Only for the documentation site

You do not need protoc. The protobuf contract is compiled in pure Rust with protox.

Debian / Ubuntu

Terminal
sudo apt-get install -y build-essential clang libclang-dev

macOS

Terminal
xcode-select --install

Build and run

Terminal
cargo build --release -p agenttx-protocol
./target/release/agenttx --help

The binary is self-contained. RocksDB is statically linked.

Docker

The repository ships a multi-stage Dockerfile that produces a slim runtime image:

Terminal
docker build -t agenttx .
docker run --rm -p 50051:50051 -v agenttx-data:/data agenttx

See Deploy & operate for production settings.

Working on the monorepo

The repository is a Turborepo monorepo with a Cargo workspace inside it:

Text
crates/agenttx-protocol   Rust server and library
crates/agenttx-bench      benchmark harness
apps/docs                 this website (Next.js)
packages/content          GitHub/local content loader + Markdown pipeline
packages/benchmarks       benchmark result schema and metrics
packages/ui               shared React components and charts
docs/                     documentation source (Markdown)
benchmarks/results        committed benchmark results (JSON)
Terminal
pnpm install
pnpm dev          # docs site on http://localhost:3000
pnpm test         # Rust and TypeScript tests through Turborepo
pnpm bench        # run the benchmark suite and update benchmarks/results/latest.json
Edit this page Report an issue