Buddy AI - Comprehensive AI Agent Framework

 [](https://badge.fury.io/py/buddy-ai) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://github.com/esasrir91/buddy-ai/stargazers)

Overview

Buddy AI is a comprehensive Python framework designed for building, deploying, and managing intelligent AI agents with enterprise-grade capabilities. It provides a unified interface to work with multiple LLM providers, advanced memory systems, and extensible tool frameworks.

🚀 Key Features

🤖 Advanced Agent System

• Intelligent Agents with persistent memory and personality
• Multi-Agent Teams with sophisticated orchestration
• Agent Evolution through automated improvement mechanisms
• Personality Engine for emotional intelligence and behavioral modeling

🧠 Multi-Model Support

• 25+ LLM Providers: OpenAI, Anthropic, Google, AWS Bedrock, Azure, Cohere, and more
• Unified Interface across all providers
• Model Switching and failover capabilities
• Custom Model Integration support

🛠️ Extensible Tool System

• 200+ Built-in Tools for common tasks
• Custom Tool Creation with simple decorators
• Function Calling with automatic schema generation
• Tool Composition and chaining capabilities

🧠 Advanced Memory Architecture

• Conversation Memory with intelligent summarization
• Long-term Memory storage and retrieval
• User-specific Memories across sessions
• Knowledge Integration with RAG capabilities

🌐 Knowledge Management

• Multi-format Document Processing (PDF, DOCX, MD, etc.)
• Vector Database Integration (ChromaDB, Pinecone, Weaviate)
• Intelligent RAG with semantic search and ranking
• Real-time Knowledge Updates

🚀 Production-Ready Deployment

• FastAPI Integration for REST APIs
• Streamlit Apps for interactive interfaces
• Docker & Kubernetes support
• Enterprise Security features

🏗️ Architecture Overview

graph TD
    A[User Input] --> B[Agent]
    B --> C[Model Provider]
    B --> D[Memory System]
    B --> E[Tool System]
    B --> F[Knowledge Base]

    C --> G[OpenAI/Anthropic/etc.]
    D --> H[Vector Storage]
    E --> I[Built-in Tools]
    E --> J[Custom Tools]
    F --> K[Documents/URLs]

    B --> L[Response Generation]
    L --> M[User Output]

🎯 Core Modules

Module	Description	Features
Agent	Core agent implementation	Memory, tools, personality, evolution
Models	LLM provider integrations	25+ providers, unified interface
Tools	Function calling system	200+ tools, custom creation
Memory	Memory management	Conversation, long-term, user memories
Knowledge	RAG and document processing	Multi-format, vector search
Team	Multi-agent collaboration	Orchestration, communication
Workflows	Process automation	Template-based, execution engine
Training	Model fine-tuning	Data prep, training, evaluation
CLI	Command-line interface	Workspace management, operations
API	REST API framework	FastAPI integration, endpoints

🚦 Quick Start

Installation

pip install buddy-ai[all]

Basic Agent

from buddy import Agent
from buddy.models.openai import OpenAIChat

agent = Agent(
    name="Assistant",
    model=OpenAIChat(),
    instructions="You are a helpful assistant."
)

response = agent.run("Hello, what can you do?")
print(response.content)

With Memory and Tools

from buddy import Agent
from buddy.models.openai import OpenAIChat
from buddy.tools.web import DuckDuckGoSearch
from buddy.memory.agent import AgentMemory

agent = Agent(
    name="ResearchBot",
    model=OpenAIChat(),
    memory=AgentMemory(),
    tools=[DuckDuckGoSearch()],
    instructions="You are a research assistant that can search the web."
)

response = agent.run("What are the latest developments in AI?")
print(response.content)

📚 Documentation Structure

This documentation is organized into the following sections:

• Getting Started - Installation, setup, and first steps
• Core Concepts - Understanding the fundamental components
• Agent Framework - Deep dive into agent capabilities
• Model Providers - Working with different LLM providers
• Tools & Functions - Building and using tools
• Memory System - Managing agent memory and state
• Knowledge Management - RAG and document processing
• Advanced Features - Multi-modal, reasoning, planning
• Examples & Tutorials - Practical examples and use cases

🤝 Community & Support

• GitHub: esasrir91/buddy-ai
• Issues: Bug Reports & Feature Requests
• Discussions: Community Forum

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

**Ready to build intelligent AI agents?** [Get started now →](getting-started/installation.md)