Skip to content

Xaibo

A modular agent framework designed for building flexible AI systems with clean protocol-based interfaces

🧩 Modular Architecture

Easily swap components without changing other parts of the system. Want to switch from OpenAI to Anthropic? Just change the configuration.

🔌 Protocol-Based Design

Components communicate through well-defined interfaces, creating clean boundaries and enabling superior testing capabilities.

🔍 Complete Observability

Every component interaction is captured with transparent proxies, providing detailed runtime insights and automatic test case generation.

What is Xaibo?

Xaibo is a powerful, protocol-driven framework that enables developers to build sophisticated AI agents with unprecedented flexibility and modularity. By using well-defined interfaces and dependency injection, Xaibo allows you to create, test, and deploy AI systems that are both robust and easily maintainable.

Quick Start

Prerequisites: Python 3.10 or higher installed

Get up and running with Xaibo in minutes: 

pip install uv
uvx xaibo init my_project
cd my_project
uv run xaibo dev
Start with our Getting Started guide guide to create your first Xaibo agent

Why Choose Xaibo?

🧩 Modular Architecture

Easily swap components without changing other parts of the system. Want to switch from OpenAI to Anthropic? Just change the configuration.

🔌 Protocol-Based Design

Components communicate through well-defined interfaces, creating clean boundaries and enabling superior testing capabilities.

🔍 Complete Observability

Every component interaction is captured with transparent proxies, providing detailed runtime insights and automatic test case generation.

🚀 Production Ready

Built-in web server with OpenAI-compatible API and MCP (Model Context Protocol) support for seamless integration.

Key Features

  • Protocol-Based Architecture

    Components interact through well-defined protocol interfaces, creating clear boundaries and enabling easy testing with mocks.

  • Dependency Injection

    Explicitly declare what components need, making it easy to swap implementations and inject predictable mocks for testing.

  • Transparent Proxies

    Every component is wrapped with observability that captures parameters, timing, and exceptions for complete visibility.

  • Comprehensive Event System

    Built-in event system provides real-time monitoring, call sequences tracking, and performance insights.

Quick Navigation

  • Getting Started

    Step-by-step tutorial to build your first AI agent with tools and understand Xaibo's architecture

  • How-to Guides

    Practical guides for installation, tool integration, LLM configuration, and deployment

  • Core Concepts

    Deep dive into protocols, modules, dependency injection, and Xaibo's design principles

  • API Reference

    Complete technical documentation for modules, protocols, configuration, and CLI commands

  • Building Tools

    Learn to create custom Python and MCP tools that extend your agent's capabilities

  • Architecture Guide

    Understand Xaibo's protocol-based architecture and transparent proxy system

Visual Debug Interface

Xaibo includes a powerful debug UI that visualizes your agent's operations in real-time:

Xaibo Debug UI - Sequence Diagram Overview

Sequence Diagram Overview

Xaibo Debug UI - Detail View

Detail View of Component Interactions

Community & Support

Ready to Build?

Start with our Getting Started guide to create your first Xaibo agent, or dive into Core Concepts to understand the framework's architecture.