Skip to content

A framework for building and composing AI agents built in Rust. Build simply using YAML or rust-script. Leverage mcp-servers right away.

License

Notifications You must be signed in to change notification settings

distrihub/distri

Repository files navigation

Distri: A Composable Agent Framework

Distri is a framework for building and composing AI agents, written in Rust. It enables developers to create, publish, and combine agent capabilities using the MCP (Multi-Agent Communication Protocol) standard.

Distri Screenshot

Getting Started

Distri agents can be configured and run in two ways:

1. YAML Configuration

2. Rust Scripts (Advanced Workflows) Coming Soon

Lets explore running distri using a sample configuration file.

List Agents

distri list -c samples/config.yaml

Distri Agents

You can run github_explorer using:

distri run -c samples/config.yaml github_explorer

Installation

You can install Distri in two ways:

Using Cargo

cargo install --git /~https://github.com/distrihub/distri distri --locked

Using Docker

docker run -it distrihub/distri

MCP Proxy & Tools

Distri proxy also provides a convenient proxy to run stdio commands.

distri proxy -c samples/proxy.yaml

For looking at all the available tools

distri list-tools -c samples/config.yaml

MCPs available via proxy

AI Gateway

Distri is connected to AI Gateway and has access to 250+ LLMs. For more details checkout Langdb AI Gateway.

What is MCP?

MCP (Multi-Agent Communication Protocol) is a standardized protocol that enables agents to:

  • Communicate with each other in a structured way
  • Share capabilities and tools
  • Execute tasks collaboratively
  • Handle state management and coordination

With MCP, any agent can be published as a reusable tool that other agents can leverage, creating an ecosystem of composable AI capabilities.

Features

  • 🔧 Modular Design: Build agents as independent modules that can be mixed and matched
  • 🤝 MCP Protocol: Standardized communication between agents
  • 🚀 Rust Performance: Built with Rust for reliability and speed
  • 📦 Tool Publishing: Share your agents as MCP-compatible tools
  • 🔌 Easy Integration: Simple API for adding new capabilities

Configuration

Distri agents can be configured in two ways:

1. YAML Configuration

2. Rust Scripts (Advanced Workflows) Coming Soon

Status

⚠️ Early Development: Distri is in early stages of development. APIs and protocols may change as we gather feedback and improve the framework.

Getting Started

[Documentation and examples coming soon]

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Contributing

We welcome contributions! Please see our CONTRIBUTING.md guide for details.

About

A framework for building and composing AI agents built in Rust. Build simply using YAML or rust-script. Leverage mcp-servers right away.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages