mammoth

Mammoth

A DOT-based pipeline runner for LLM agent workflows. Define a graph, run it, watch it think.

Go implementation of the StrongDM Attractor specification.

Architecture

Mammoth is three layers, bottom-up:

Supporting packages: dot/ (DOT parser/serializer), spec/ (event-sourced spec builder), web/ (unified web layer), editor/ (DOT graph editor), render/ (DOT→SVG/PNG), tui/ (Bubble Tea terminal UI), cmd/mammoth/ (CLI).

Install

Homebrew (macOS/Linux)

brew install 2389-research/tap/mammoth

Go

go install github.com/2389-research/mammoth/cmd/mammoth@latest

Download binary

Pre-built binaries for macOS and Linux (amd64/arm64) are available on the releases page.

# Example: Linux amd64 — replace VERSION with the desired release (e.g. 0.2.0)
VERSION="0.2.0"
curl -sL "https://github.com/2389-research/mammoth/releases/download/v${VERSION}/mammoth_${VERSION}_Linux_x86_64.tar.gz" | tar xz
sudo mv mammoth /usr/local/bin/

Build from source

git clone https://github.com/2389-research/mammoth.git
cd mammoth
make build
# Binary is at ./bin/mammoth

Quick Start

# Set an API key (at least one required)
export ANTHROPIC_API_KEY="sk-ant-..."
# or: export OPENAI_API_KEY="sk-..."
# or: export GEMINI_API_KEY="..."

# Run a pipeline
mammoth run pipeline.dot

Usage

# Validate a pipeline without running it
mammoth -validate pipeline.dot

# Run with the terminal UI
mammoth run -tui pipeline.dot

# Start the HTTP server
mammoth -server -port 8080

Testing

# Run all tests (5,200+ tests)
go test ./...

# Run with race detector
make test-race

# Run with coverage
go test ./... -coverprofile=coverage.out
go tool cover -func=coverage.out

Documentation

• Quickstart — Get a pipeline running in under five minutes
• CLI Usage — Pipeline execution, validation, and server mode
• CLI Specification — Commands, flags, output formats, and exit codes
• DSL Reference — DOT digraph syntax for LLM agent pipelines
• Handlers — 9 built-in execution units
• Backend Configuration — Provider keys, model catalog, retry
• API Reference — Go packages, HTTP endpoints, types, and events
• Walkthrough — Write, validate, and run pipelines from scratch
• Parity Matrix — Spec coverage tracking
• Test Coverage — Per-package thresholds

Browse the full docs hub at docs/index.html.

Spec Parity

192/195 Attractor spec requirements implemented (3 partial, 0 missing). See the parity matrix for details.

License

MIT License. See LICENSE for details.

Built by 2389 Research, Inc. | hello@2389.ai