Distri

Distri is an A2A-compatible agent framework built in Rust. Build agents with simple markdown definitions and integrate them within your React frontend. Tools can be added as either backend tools via Deno or frontend tools, making building agents much easier.

Documentation · Website · A2A Protocol

Architecture

Distri is organized as a monorepo with Rust crates and TypeScript packages:

distri/
├── Rust Crates
│   ├── distri-cli          # CLI tool for agent management
│   ├── distri-a2a          # A2A protocol implementation
│   ├── distri-types        # Shared type definitions
│   ├── distri-filesystem   # File system utilities
│   └── distri              # Core library
│
├── Server (ELv2 License)
│   ├── distri-server       # A2A-compatible agent server
│   ├── distri-core         # Core server logic
│   ├── distri-stores       # Storage backends
│   ├── distri-plugins      # Plugin system
│   └── distri-plugin-executor  # Deno-based plugin runtime
│
├── DistriJS (TypeScript)
│   ├── @distri/core        # Agent client & A2A integration
│   ├── @distri/react       # React hooks & components
│   ├── @distri/components  # Shared UI components (shadcn/ui)
│   └── @distri/fs          # File system tools for frontend
│
├── samples/                # Example applications
└── plugins/                # Integration plugins

Screenshots

Installation

Prebuilt binary (recommended)

curl -fsSL https://distri.dev/install.sh | sh

Pin a specific version or choose an install location:

DISTRI_VERSION=0.3.0 DISTRI_INSTALL_DIR=/usr/local/bin sh -c "$(curl -fsSL https://distri.dev/install.sh)"

Direct download (macOS / Linux)

# darwin-arm64 | darwin-x86_64 | linux-arm64 | linux-x86_64
TARGET=darwin-arm64
curl -L "https://github.com/distrihub/distri/releases/latest/download/distri-${TARGET}.tar.gz" -o distri.tar.gz
sudo tar -xzf distri.tar.gz -C /usr/local/bin distri

Homebrew (macOS / Linux)

brew tap distrihub/distri
brew install distri

Windows (PowerShell)

Invoke-WebRequest https://github.com/distrihub/distri/releases/latest/download/distri-windows-x86_64.zip -OutFile distri.zip
Expand-Archive distri.zip -DestinationPath $Env:LOCALAPPDATA\distri -Force
$Env:Path += ";$Env:LOCALAPPDATA\distri"

Verify installation

distri --version
distri help

Quick Start

# Navigate to your project
cd path/to/your/project

# Push agents to Distri Cloud
distri push

# Run a task
distri run --agent <agent-name> --task "Your task"

Samples

Embedding in iframe

<iframe
  src="https://distrihub.github.io/distri/samples/maps"
  width="100%"
  height="600"
  frameborder="0">
</iframe>

Plugins

Ready-to-use integrations in plugins/:

Development

Building Rust crates

cargo build

Publishing crates

cargo publish -p distri-a2a
cargo publish -p distri-types
cargo publish -p distri-filesystem
cargo publish -p distri

DistriJS development

cd distrijs
pnpm install
pnpm dev

Releases

Check the GitHub Releases page for the latest binaries and changelog.

Licensing

• Repository root and common components: MIT License
• Server components (server/): Elastic License 2.0 - follows fair-code principles

Support

Questions or feedback? Open an issue.