klieo 1.1.0

Open-source Rust agent framework — typed agents, durable inter-agent comms, local-first.
Documentation

klieo

Open-source Rust agent framework — typed agents, durable inter-agent comms, local-first.

crates.io docs.rs MIT

What it is

klieo is a Rust agent framework that wires LLM clients, tools, memory, and inter-agent messaging behind a clean trait surface. Build agents that call local or remote LLMs, persist memory to SQLite/Qdrant/Neo4j, communicate over NATS or in-process bus, and expose themselves as MCP servers or A2A endpoints.

Feature flags

Flag Adds Default
local tools, macros, llm-ollama, memory-sqlite, bus-memory on
all-foundation tools, macros, llm-ollama, memory-sqlite, bus-memory, bus-nats, mcp off
all-llm llm-openai, llm-anthropic, llm-gemini (+ llm-ollama) off
all-memory memory-sqlite, memory-neo4j, memory-qdrant, embed-common off
all-observability runlog, otel, provenance off
full All flags above off

Quickstart

[dependencies]
klieo = { version = "1", features = ["full"] }
tokio = { version = "1", features = ["full"] }
anyhow = "1"

use klieo::prelude::*;

#[klieo::tool(description = "Returns a greeting.")]
async fn greet(_ctx: &ToolCtx, name: String) -> Result<String, ToolError> {
    Ok(format!("Hello, {name}!"))
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let app = App::local_at("klieo.db")
        .tool(GreetTool)
        .build()
        .await?;
    let agent = SimpleAgent::new("greeter", "Be helpful.", app.tools_catalogue().to_vec());
    let reply = app.run(&agent, "say hi to Alex".into()).await?;
    println!("{reply}");
    Ok(())
}

Crate catalogue

Crate Purpose
klieo-core Trait surface: Agent, Tool, LlmClient, memory, bus
klieo-mcp-server Expose tools as an MCP server over stdio or HTTP
klieo-a2a Durable A2A v1.0 protocol over NATS
klieo-bus-nats Production NATS JetStream bus
klieo-bus-memory In-process bus for dev and testing
klieo-llm-ollama Local Ollama LLM client
klieo-llm-openai OpenAI Chat Completions
klieo-llm-anthropic Anthropic Messages API
klieo-llm-gemini Google Gemini
klieo-memory-sqlite SQLite memory backends
klieo-memory-qdrant Qdrant vector memory
klieo-memory-neo4j Neo4j graph memory
klieo-flows Multi-agent composition
klieo-ops Production operations layer

Resources

Status

1.x — stable. Minor releases may add public items. See docs/SEMVER.md.

License

MIT — see LICENSE.