Distri is an open-source AI agent framework built in Rust. Define agents in markdown, connect your product functions as tools, and run them from the CLI, as an API server, or embedded in your React UI.

Documentation · Website · Distri Cloud

• Agents as markdown — Define behavior, tools, and model settings in a single .md file with TOML frontmatter
• Built-in tool system — Builtins (search, shell, browser), dynamic HTTP tools, external client-side tools, and MCP support
• Skills — On-demand knowledge documents agents load at runtime via load_skill, with automatic re-injection after context compaction
• Sub-agents — Agents delegate to specialized child agents with isolated context and token budgets
• Remote execution — Run agents in sandboxed containers for untrusted code or resource isolation
• React SDK — Drop-in <Chat /> component with streaming, tool renderers, voice, and developer mode
• A2A compatible — Implements the A2A protocol for agent discovery and invocation
• Self-hosted — Run on your own infrastructure with SQLite. No external dependencies required.

# Install script (macOS / Linux)
curl -fsSL https://distri.dev/install.sh | sh

# Homebrew
brew tap distrihub/distri && brew install distri

# Verify
distri --version

# 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

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"

distri run search --task "What are the top programming languages in 2026?"

Create agents/my_agent.md:

---
name = "my_agent"
description = "A helpful assistant with web search"
max_iterations = 15

[tools]
builtin = ["final", "search"]
---

# My Agent

You are a helpful assistant. Use the search tool to find current information.

{{task}}

# Interactive chat
distri tui my_agent

# Single task
distri run --agent my_agent --task "Find the latest SpaceX launch date"

# Start as API server
distri serve --port 8080

distri login
distri agents push agents/my_agent.md

Requires BROWSR_BASE_URL and BROWSR_API_KEY for search, browser, and shell tools. Configured automatically on Distri Cloud.

Agents are markdown files with TOML frontmatter:

---
name = "my_agent"
description = "What this agent does"
max_iterations = 25
context_size = 80000
sub_agents = ["search", "code"]     # delegate to other agents

[tools]
builtin = ["final", "search", "load_skill"]
external = ["Read", "Write", "Edit"]  # client-side tools

[[tools.dynamic]]
name = "my_api"
type = "http"
description = "Call my API"
config = { base_url = "$API_URL", headers = { "Authorization" = "Bearer $TOKEN" } }

[[available_skills]]
id = "*"
name = "*"
---

# System Prompt

Your instructions here. Supports Handlebars templates:
- {{task}} — the user's message
- {{> skills}} — available skills listing
- {{> connections}} — available connections

See Agent Definition docs for the full schema.

Skills are reusable instruction documents agents load on demand:

---
name = "data_pipeline"
description = "How to run the data transformation pipeline"
tags = ["data", "etl"]
context = "inline"
---

# Data Pipeline

## Steps
1. Fetch data with `my_api` tool...
2. Transform using Python...

# Push skills
distri skills push skills/data_pipeline.md
distri skills list

Agents call load_skill("data_pipeline") at runtime. Two modes:

• Inline (default) — content injected into conversation, survives context compaction
• Fork — spawns isolated child agent with skill as instructions

Embed agents in your React app:

npm install @distri/react

import { useAgent, Chat } from '@distri/react';

function App() {
  const { agent } = useAgent({ agentIdOrDef: 'my_agent' });
  return <Chat agent={agent} threadId="conversation-1" />;
}

Features: SSE streaming, tool execution with custom renderers, voice I/O, developer mode, browser-side file tools (IndexedDB-backed Read/Write/Edit/Glob/Grep).

See the DistriJS docs for full integration guide.

distri                              # Interactive TUI
distri run --task "..." [--agent A] # Run a task
distri run --task "..." --remote    # Run in sandboxed container

distri agents list / push / delete  # Manage agents
distri skills list [-a] / push      # Manage skills
distri traces list / show ID [-v]   # Debug with trace viewer
distri tools list / invoke          # Inspect and test tools

distri connections list / token     # OAuth connections
distri secrets list / set / delete  # Manage secrets
distri workflows run / push         # DAG workflows

distri serve --port 8080            # Start API server
distri login                        # Auth with Distri Cloud
distri profile list / use / config  # Multi-profile management

distri/
├── distri-types/          # Shared type definitions
├── distri-cli/            # CLI binary
├── distri/                # Client library
├── distri-formatter/      # Output formatting
│
├── server/
│   ├── distri-core/       # Agent engine (orchestrator, loop, tools, LLM)
│   ├── distri-server/     # HTTP server (actix-web, A2A endpoints)
│   ├── distri-stores/     # Storage backends (SQLite, Postgres)
│   ├── distri-auth/       # Auth providers
│   ├── distri-parsers/    # Parsing utilities
│   └── agents/            # Built-in agent definitions (.md)
│
├── distrijs/              # TypeScript SDK
│   ├── @distri/core       # Agent client, A2A streaming
│   ├── @distri/react      # React hooks, Chat component, browser tools
│   └── @distri/components # Shared UI (shadcn/ui)
│
└── samples/               # Example applications
    ├── maps-demo/         # Google Maps + AI chat
    └── scraper/           # Web scraping agent

User message → AgentOrchestrator
  → Load agent definition
  → Create ExecutorContext (thread, task, run)
  → AgentLoop
    → PlanningStrategy.plan() → LLM produces plan
    → ExecutionStrategy.execute_step() per step
      → Tool calls (builtin, dynamic, external, MCP)
      → Event streaming (SSE)
    → Loop until final tool or max iterations
  → Return result

# Build
cargo build

# Run tests
cargo test

# Test a specific crate
cargo test -p distri-core

# DistriJS development
cd distrijs && pnpm install && pnpm dev

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

• Documentation
• Distri Cloud
• GitHub Releases
• Issues