Brainwires Framework

A modular Rust framework for building AI agents with multi-provider support, tool orchestration, MCP integration, and pluggable agent networking.

Overview

The Brainwires Framework is a workspace of 19 framework crates plus 6 extras that provide everything needed to build, train, deploy, and coordinate AI agents. Each framework crate is independently publishable to crates.io and usable standalone, but they compose together through the brainwires facade crate for a batteries-included experience.

Full feature list | Key capabilities:

• Multi-provider AI — Anthropic, OpenAI, Google, Ollama, and local LLMs behind a unified Provider trait
• Agent orchestration — hierarchical task decomposition, multi-agent coordination with file locks, MDAP voting
• MCP protocol — full client and server support via rmcp, exposing agents as MCP tools
• Agent networking — 5-layer protocol stack (IPC, TCP, A2A, Pub/Sub) with pluggable transports, routing, and discovery
• Training pipelines — cloud fine-tuning (6 providers) and local LoRA/QLoRA/DoRA via Burn
• RAG & code search — AST-aware chunking, hybrid vector + keyword search, Git-aware indexing
• Audio — speech-to-text, text-to-speech, hardware capture/playback
• Security — encrypted storage (ChaCha20-Poly1305), permission policies, content trust tagging

Crate Map

  ┌────────────────────────────────────────────────────────────┐
  │                        brainwires                          │
  │                      (facade crate)                        │
  │                                                            │
  │  ┌───────────┐ ┌────────────┐ ┌───────────┐ ┌───────────┐  │
  │  │  agents   │ │  providers │ │  storage  │ │    mcp    │  │
  │  │  mdap     │ │tool-system │ │ cognition │ │agent-net  │  │
  │  └─────┬─────┘ └──────┬─────┘ └─────┬─────┘ └─────┬─────┘  │
  │        │              │             │             │        │
  │        └──────────────┴─────────────┴─────────────┘        │
  │                            │                               │
  │                     ┌──────▼──────┐                        │
  │                     │    core     │                        │
  │                     │ permissions │                        │
  │                     └─────────────┘                        │
  │                                                            │
  │  ┌──────────┐ ┌────────────┐ ┌───────────┐ ┌───────────┐   │
  │  │  skills  │ │  datasets  │ │ training  │ │   audio   │   │
  │  │code-inter│ │  autonomy  │ │    a2a    │ │    wasm   │   │
  │  └──────────┘ └────────────┘ └───────────┘ └───────────┘   │
  └────────────────────────────────────────────────────────────┘

Framework Crates

Extras

Getting Started

Requirements

• Rust 1.91+ (edition 2024)
• Cargo (comes with Rust)

Note: This framework uses edition = "2024" which requires Rust 1.91 or newer. Check your version with rustc --version and update with rustup update stable if needed.

Using the Facade Crate

The simplest way to use the framework is through the brainwires facade crate, which re-exports everything behind feature flags:

[dependencies]
brainwires = "0.6"  # defaults: tools + agents

Enable only what you need:

[dependencies]
brainwires = { version = "0.6", features = ["providers", "rag"] }

Using Individual Crates

Each crate is independently publishable and usable:

[dependencies]
brainwires-core = "0.6"
brainwires-providers = "0.6"
brainwires-agents = "0.6"

Minimal Example

use brainwires::prelude::*;
use brainwires::providers::{ChatProviderFactory, ProviderConfig, ProviderType};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // Create a provider via the factory
    let config = ProviderConfig {
        provider: ProviderType::Anthropic,
        model: "claude-sonnet-4-20250514".into(),
        api_key: Some("your-api-key".into()),
        base_url: None,
    };
    let provider = ChatProviderFactory::create(&config)?;

    // Send a message
    let messages = vec![Message::user("Hello, what can you do?")];
    let options = ChatOptions::default();
    let response = provider.chat(&messages, None, &options).await?;

    println!("{}", response.message.content);
    Ok(())
}

Feature Flags

The brainwires facade crate exposes feature flags corresponding to each sub-crate:

Building

# Build all crates (debug)
cargo build

# Build all crates (release)
cargo build --release

# Build a specific crate
cargo build -p brainwires-agents

# Run all tests
cargo test

# Run tests for a specific crate
cargo test -p brainwires-core

Dependency DAG

  brainwires (facade)
  ├── brainwires-agents
  │   ├── brainwires-core
  │   ├── brainwires-tool-system
  │   └── brainwires-cognition (seal-knowledge feature)
  ├── brainwires-cognition
  │   ├── brainwires-core
  │   └── brainwires-storage (knowledge feature)
  ├── brainwires-storage
  │   └── brainwires-core
  ├── brainwires-mcp
  │   └── brainwires-core
  ├── brainwires-agent-network
  │   ├── brainwires-core
  │   ├── brainwires-mcp
  │   └── brainwires-a2a (a2a-transport feature)
  ├── brainwires-training
  │   ├── brainwires-core
  │   ├── brainwires-datasets
  │   └── brainwires-providers (cloud feature)
  └── brainwires-audio
      (standalone — no internal deps beyond core traits)

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.