Crate bamboo_agent 

Bamboo - A fully self-contained AI agent backend framework

Bamboo provides a complete backend system for AI agents, including:

• Built-in HTTP/HTTPS server (Actix-web)
• Agent execution loop with tool support
• LLM provider integrations (OpenAI, Anthropic, Google Gemini, GitHub Copilot)
• Session management and persistence
• Workflow and slash command systems
• Process management for external tools

Features

• Dual mode: Binary (standalone server) or library (embedded)
• Unified directory: All data in the Bamboo data directory (default ${HOME}/.bamboo)
• Production-ready: Built-in CORS, rate limiting, security headers

Quick Start

Binary Mode

bamboo serve --port 9562 --data-dir "$HOME/.bamboo"

Library Mode

use bamboo_agent::{BambooServer, Config};

#[tokio::main]
async fn main() {
    let config = Config::new();
    let server = BambooServer::new(config);
    server.start().await.unwrap();
}

Re-exports

pub use error::BambooError;

pub use error::Result;

pub use bamboo_server as server;

pub use bamboo_tools as tools;

pub use bamboo_infrastructure as infrastructure;

pub use bamboo_config as config;

Modules

actor_cli

The bamboo actor run CLI: drive an actor from the terminal. bamboo actor … / bamboo -p — drive actors from the terminal.

admin_cli

The bamboo health|status|sessions|stop admin CLI: a thin HTTP client over a running bamboo serve for operators (health probe, session list/stop). The bamboo health | status | sessions | stop admin CLI.

agent

Ergonomic top-level Agent SDK.

broker_agent

The bamboo broker-agent serve worker: connect to a central broker and answer Ask/Task (query/steer) for its mailbox; deployable local/Docker/remote. bamboo broker-agent serve: a long-lived agent that connects to a central message broker and answers Ask/Task for its own mailbox (query/steer modes).

commands

Command and workflow management

core

error

Error types for Bamboo

headless

The bamboo -p headless server mode: full AppState, one-shot, resumable. bamboo -p — a COMPLETE bamboo server, headless: boots the full AppState (root tool surface incl. SubAgent → can spawn actor children), runs the prompt on a root session through the same execute path the HTTP API uses, streams events to the terminal, and exits when the whole tree is finished (parent + children, including suspend/resume coordination).

subagent_worker

The bamboo subagent-worker actor worker (provision via stdin, serve over WS). bamboo subagent-worker — the real actor worker.

Structs

Agent

Stable, ergonomic entry point for agent execution.

AgentBuilder

Ergonomic builder for Agent.

BambooBuilder

Builder pattern for creating BambooServer

BambooServer

Main Bamboo server instance

Config

Main configuration structure for Bamboo agent

ServerConfig

HTTP server configuration