MUXI

📚 Read the whitepaper  │  ⭐️ Star this repo

MUXI is an ambitious project that provides a powerful, open-source framework for building multi-AI-agent systems with sophisticated orchestration capabilities.

MUXI delivers persistent memory, standardized communication protocols, and chain-of-thought tracing, while seamlessly integrating multiple interfaces including CLI, API/WS, Web UI, MCP, and WebRTC.

The stated goal is to offer a comprehensive platform that will serve as a solid foundation for developers seeking to create advanced AI applications with real-time communication and MCP server integration, enabling complex agent interactions within a modular, extensible environment.

Features

• 🤖 Multi-Agent Support: Create and manage multiple AI agents with different capabilities
• 🧠 Memory Systems: Short-term and long-term memory for contextual interactions
  • FAISS for short-term buffer memory
  • SQLite with sqlite-vec for local or lightweight deployments
  • PostgreSQL with pgvector for scalable long-term memory
  • Memobase for user-level profile-based memory system
  • Automatic extraction of user information from conversations and storing it in context memory
• 🔌 MCP Client Integration: Connect to external services via Model Context Protocol servers
  • Support for HTTP+SSE transport for web-based MCP servers
  • Support for Command-line transport for local executable servers
  • Robust reconnection mechanism with exponential backoff
  • Comprehensive error handling and diagnostics
  • Cancellation support for long-running operations
• 🌟 MCP Server Implementation: Expose your agents as MCP-compatible servers
  • SSE-based server endpoint for MCP host integration
  • Tool discovery from agent capabilities
  • Authentication shared with REST API
  • Bridge package for non-SSE clients
• 🔄 Agent-to-Agent (A2A) Communication: Enable structured communication between agents
  • Standardized message format for inter-agent communication
  • Capability registration and discovery
  • Task delegation between specialized agents
  • Context sharing with proper isolation
  • Security and authentication
• 🌐 Multiple Interfaces: REST API, WebSockets, CLI, Web UI, etc.
• 🔄 Intelligent Message Routing: Automatically direct messages to the most appropriate agent
• 📊 Multi-User Support: User-specific memory partitioning for multi-tenant applications
• 📘 Context Memory: Store and retrieve structured information to personalize responses
• 🔍 Agent-Level Knowledge Base: Provide agents with specialized domain knowledge via lightweight RAG
• 🔄 Hybrid Communication Protocol: HTTP for standard requests, SSE for streaming, WebSockets for multi-modal
• 📝 Declarative Configuration: Define agents using YAML or JSON files with minimal code
• 🚀 Modular Architecture: Use only the components you need
• 🌍 Language-Specific SDKs: Client libraries for TypeScript/JavaScript, Go, and more

Technical Details

Communication Protocols

MUXI implements a hybrid protocol approach for optimal performance and flexibility:

• HTTP: For standard API requests like configuration and management
• Server-Sent Events (SSE): For streaming responses token-by-token
• WebSockets + WebRTC: For multi-modal capabilities with bi-directional communication

Package Structure

The MUXI Framework is organized into a modular architecture with the following components:

muxi-framework/
├── packages/
│   ├── core/          # Core components: agents, memory, MCP interface
│   ├── server/        # REST API and WebSocket server
│   ├── cli/           # Command-line interface
│   ├── web/           # Web user interface
│   └── muxi/          # Meta-package that integrates all components
└── tests/             # Test suite for all components

Language-Specific SDKs

MUXI Framework will provide client libraries for popular programming languages.

Each SDK will provide:

• Full REST API client implementation
• WebSocket client for real-time communication
• MCP server protocol implementation
• Consistent developer experience across languages

License

This project is licensed under a dual licensing model to balance open-source collaboration with sustainable business practices.

Development Phase (Pre-Version 1.0)

The software is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 (CC BY-NC-ND 4.0) during the development phase. This license prohibits commercial use, derivative works, and redistribution to ensure the integrity of the development process and to avoid project fragmentation before it reaches maturity.

After Version 1.0 Release

When the project reaches version 1.0, it will switch to a more permissive open-source license that permits unrestricted use for non-commercial use cases and extensive use for commercial use cases.

Acknowledgements

The many open-source projects that make this framework possible ❤️