Quick Start

Get TALA running in under five minutes.

Prerequisites

• Rust 1.82+ (recommended via rustup)
• Docker and Docker Compose (for the observatory demo)

Clone and Build

git clone https://github.com/copyleftdev/tala.git
cd tala
cargo build --release

The workspace compiles 12 crates. The first build downloads dependencies and takes a few minutes.

Run the Test Suite

cargo test --workspace

Run Benchmarks

cargo bench

Criterion benchmarks live in crates/<name>/benches/. Results are written to target/criterion/ with HTML reports.

Launch the Observatory Demo

The fastest way to see TALA in action is the Docker Compose demo. It runs four simulated Linux operations domains — Incident Response, Continuous Deployment, Observability, and System Provisioning — each generating realistic shell commands, structuring them into intent narratives, and exporting metrics to Prometheus.

cd deploy
cp .env.example .env     # adjust settings if desired
docker compose up -d

Open your browser:

The observatory landing page tells the TALA story, then lets you enter a live topology view of the system. Click any node to drill into its telemetry.

Tear Down

docker compose down -v

The -v flag removes named volumes. Omit it to preserve data between restarts.