solace-agent-mesh

solace-agent-mesh

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.

Stars: 516

Visit
 screenshot

Solace Agent Mesh is an open-source framework designed for building event-driven multi-agent AI systems. It enables the creation of teams of AI agents with distinct skills and tools, facilitating communication and task delegation among agents. The framework is built on top of Solace AI Connector and Google's Agent Development Kit, providing a standardized communication layer for asynchronous, event-driven AI agent architecture. Solace Agent Mesh supports agent orchestration, flexible interfaces, extensibility, agent-to-agent communication, and dynamic embeds, making it suitable for developing complex AI applications with scalability and reliability.

README:

Solace Agent Mesh Logo

Solace Agent Mesh

Open-source framework for building event driven multi-agent AI systems

Star ⭐️ this repo to stay updated as we ship new features and improvements.

License PyPI - Version PyPI - Python Version PyPI - Downloads

Key FeaturesQuickstartNext Steps


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.


🔑 Key Features

📚 Want to know more? Check out the full Solace Agent Mesh documentation.


🚀 Quick Start (5 minutes)

Set up Solace Agent Mesh in just a few steps.

⚙️ System Requirements

To run Solace Agent Mesh locally, you'll need:

  • Python 3.10.16+
  • pip (comes with Python)
  • OS: MacOS, Linux, or Windows (with WSL)
  • LLM API key (any major provider or custom endpoint)

💻 Setup Steps

1. Create a directory for a new project

mkdir my-sam && cd my-sam

2. Create and activate a Python virtual environment

python3 -m venv .venv && source .venv/bin/activate

3. Install Solace Agent Mesh (SAM)

Check if you have a version of SAM already installed.

sam -v

If you have an earlier version, uninstall it and start from scratch:

pip3 uninstall solace-agent-mesh

Note: Optionally, you can try to upgrade versions but this action is not officially supported at this time. (pip3 install --upgrade solace-agent-mesh)

If no previous version exists, install the latest version with:

pip3 install solace-agent-mesh

4. Initialize the new project via a GUI tool

sam init --gui

Note: This initialization UI runs on port 5002

5. Run the project

sam run

6. Verify SAM is running

Open the Web UI at http://localhost:8000 for the chat interface and ask a question

🔧 Customize SAM

New agents can be added via a GUI interface

sam add agent --gui

Existing plugins can be installed

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
  • Define agent capabilities (LLM model, instructions, tools) primarily through SAC YAML configuration
  • 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
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
Enable Solace Agent Mesh to answer company-specific questions using a sample coffee company database.
~10–15 min SQL Database Tutorial
🧠 MCP Integration
Integrating a Model Context Protocol (MCP) Servers into Solace Agent Mesh.
~10–15 min MCP Integration Tutorial
💬 Slack Integration
Chat with Solace Agent Mesh directly from Slack.
~20–30 min Slack 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!

View the full list of contributors here: GitHub Contributors 💚

Looking to contribute? Check out CONTRIBUTING.md to get started and see how you can help!


📄 License

This project is licensed under the Apache 2.0 License. See the full license text in the LICENSE file.


Solace Agent Mesh Logo

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for solace-agent-mesh

Similar Open Source Tools

For similar tasks

For similar jobs