A lightweight, ergonomic framework for building AI agents in Rust.

Machi provides the building blocks for constructing AI agents that reason, use tools, and collaborate — powered by any LLM backend.

Core Concepts

• Agent — A self-contained unit with its own LLM provider, instructions, tools, and optional sub-agents.
• Runner — A stateless execution engine driving the ReAct loop (think → act → observe → repeat).
• Tool / DynTool — Capabilities that agents can invoke (filesystem, shell, web search, or custom).
• ChatProvider — Trait abstracting over LLM backends (OpenAI, Ollama, or custom).

Feature Flags

Quick Start

use machi::agent::{Agent, RunConfig};
use machi::chat::ChatRequest;
use machi::message::Message;

// Build a chat request
let request = ChatRequest::new("gpt-4o")
    .system("You are a helpful assistant.")
    .user("Hello!")
    .temperature(0.7);

// Configure an agent
let agent = Agent::new("assistant")
    .instructions("You are a helpful assistant.")
    .model("gpt-4o");

// Construct messages manually
let msgs = vec![
    Message::system("You are helpful."),
    Message::user("What is Rust?"),
];