An event-driven framework designed to build and orchestrate multi-agent AI systems. It enables seamless integration of AI agents with real-world data sources and systems, facilitating complex, multi-step workflows.
Based on repository activity, growth velocity and community engagement.
60
Growth28/30
Activity10/25
Popularity17/25
Trust5/20
4,968
Stars
High
Sentiment
Votes
4,968
README.md
⚠️ Solace Agent Mesh in Python is now deprecated
👋 Thank you to everyone who has built with Solace Agent Mesh! This Python version is now deprecated — it's no longer under active development and won't receive new features, bug fixes or security updates.
🚀 Check out the new version of Solace Agent Mesh → https://docs.solace.com/Agent-Mesh/agent-mesh.htm
🖥️ A free edition of the Solace Agent Mesh desktop app is available: https://solace.com/products/agent-mesh/download
This repository will be archived (read-only) but stays available for reference, so your existing links and installs keep working.
<p align="center">
<img src="https://raw.githubusercontent.com/SolaceLabs/solace-agent-mesh/refs/heads/main/docs/static/img/logo.png" alt="Solace Agent Mesh Logo" width="100"/>
</p>
<h2 align="center">
Solace Agent Mesh
</h2>
<h3 align="center">Open-source framework for building event driven multi-agent AI systems</h3>
<h5 align="center">Star ⭐️ this repo to stay updated as we ship new features and improvements.</h5>
<p align="center">
<a href="https://github.com/SolaceLabs/solace-agent-mesh/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/SolaceLabs/solace-agent-mesh" alt="License">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img src="https://img.shields.io/pypi/v/solace-agent-mesh.svg" alt="PyPI - Version">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img src="https://img.shields.io/pypi/pyversions/solace-agent-mesh.svg" alt="PyPI - Python Version">
</a>
<a href="https://pypi.org/project/solace-agent-mesh">
<img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/solace-agent-mesh?color=00C895">
</a>
</p>
<p align="center">
<a href="#-key-features">Key Features</a> •
<a href="#-quick-start-5-minutes">Quickstart</a> •
<a href="#️-next-steps">Next Steps</a> •
<a href="https://solacelabs.github.io/solace-agent-mesh/">Docs</a>
</p>
Solace Agent Mesh is a framework that supports building AI applications where multiple specialized AI agents work together to solve complex problems. It uses the event messaging of Solace Platform for true scalability and reliability.
With Solace Agent Mesh (SAM), you can create teams of AI agents, each having distinct skills and access to specific tools. For example, you could have a Database Agent that can make SQL queries to fetch data or a MultiModal Agent that can help create images, audio files and reports.
The framework handles the communication between agents automatically, so you can focus on building great AI experiences.
SAM creates a standardized communication layer where AI agents can:
Delegate tasks to peer agents
Share data and artifacts
Connect with diverse user interfaces and external systems
Execute multi-step workflows with minimal coupling
SAM is built on top of the Solace AI Connector (SAC) which allows Solace Platform Event Brokers to connect to AI models and services and Google's Agent Development Kit (ADK) for AI logic and tool integrations.
The result? A fully asynchronous, event-driven and decoupled AI agent architecture ready for production deployment. It is robust, reliable and easy to maintain.
LLM API key (any major provider or custom endpoint)
🎸 Vibe Coding
To quickly setup and customize your Agent Mesh, check out the Vibe Coding Quickstart Guide. This guide walks you through the essential steps to get Solace Agent Mesh up and running with minimal effort.
💻 Setup Steps
1. Create a directory for a new project
mkdir my-sam && cd my-sam
2. Create and activate a Python virtual environment
sam plugin add <your-component-name> --plugin <plugin-name>
🏗️ Architecture Overview
Solace Agent Mesh provides a "Universal A2A Agent Host," a flexible and configurable runtime environment built by integrating Google's Agent Development Kit (ADK) with the Solace AI Connector (SAC) framework.
The system allows you to:
Host AI agents developed with Google ADK within the SAC framework
Use Solace Platform as the transport for standard Agent-to-Agent (A2A) protocol communication
Enable dynamic discovery of peer agents running within the same ecosystem
Allow agents to delegate tasks to discovered peers via the A2A protocol over Solace
Manage file artifacts using built-in tools with automatic metadata injection
Perform data analysis using built-in SQL, JQ, and visualization tools
Use dynamic embeds for context-dependent information resolution
Key Components
SAC handles broker connections, configuration loading, and component lifecycle
ADK provides the agent runtime, LLM interaction, tool execution, and state management
A2A Protocol enables communication between clients and agents, and between peer agents
Dynamic Embeds allow placeholders in responses that are resolved with context-dependent information
File Management provides built-in tools for artifact creation, listing, loading, and metadata handling
➡️ Next Steps
Want to go further? Here are some hands-on tutorials to help you get started:
| 🔧 Integration | ⏱️ Est. Time | 📘 Tutorial |
|----------------|--------------|-------------|
| 🌤️ Weather Agent<br>Learn how to build an agent that gives Solace Agent Mesh the ability to access real-time weather information. | ~15 min | Weather Agent Plugin |
| 🗃️ SQL Database Integration<br>Enable Solace Agent Mesh to answer company-specific questions using a sample coffee company database.| ~10–15 min | SQL Database Tutorial |
| 🧠 MCP Integration<br>Integrating a Model Context Protocol (MCP) Servers into Solace Agent Mesh. | ~10–15 min | MCP Integration Tutorial |
| 💬 Slack Integration<br>Chat with Solace Agent Mesh directly from Slack. | ~20–30 min | Slack Integration Tutorial |
| 👔 Microsoft Teams Integration (Enterprise)<br>Connect Solace Agent Mesh Enterprise to Microsoft Teams with Azure AD authentication. | ~30–40 min | Teams Integration Tutorial |
👥 Contributors
Solace Agent Mesh is built with the help of our amazing community. Thanks to everyone who has contributed ideas, code and time to make this project better!