klieo

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

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

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

Versions reflect the current published majors; minor bumps are not called out per row. See each crate's CHANGELOG.md for fine-grained history.

Resources

• API docs
• User guide
• SEMVER policy

Status

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

License

MIT — see LICENSE.