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
• Claude Code integration

Features

• Dual mode: Binary (standalone server) or library (embedded)
• XDG-compliant: Follows XDG Base Directory specification
• Production-ready: Built-in CORS, rate limiting, security headers

Quick Start

Binary Mode

bamboo serve --port 8080 --data-dir ~/.local/share/bamboo

Library Mode

use bamboo::{BambooServer, BambooConfig};

#[tokio::main]
async fn main() {
    let config = BambooConfig::default();
    let server = BambooServer::new(config);
    // server.start().await.unwrap(); // Not yet implemented
}

Re-exports

pub use config::BambooConfig;

pub use config::ServerConfig;

pub use error::BambooError;

pub use error::Result;

pub use process::ProcessRegistry;

Modules

agent

Agent system - Complete AI agent framework

claude

Claude Code binary discovery and management

commands

Command and workflow management

config

Configuration management for Bamboo

core

Core types and utilities (migrated from chat_core)

error

Error types for Bamboo

process

Process management for external agent runs and Claude sessions

server

HTTP server (migrated from web_service)

web_service

Web service layer - HTTP controllers and services

Structs

BambooBuilder

Builder pattern for creating BambooServer

BambooServer

Main Bamboo server instance