Step 1: Install Agent Mesh
This step covers downloading and launching Solace Agent Mesh. The download is a single installer that provides both a graphical interface and a command-line tool. This tutorial uses both depending on the task.
Prerequisites
Solace Agent Mesh Desktop requires a connection to a Large Language Model (LLM) provider to power AI agent interactions. Before you begin, ensure you have at least one of the following:
-
An API key from a cloud LLM provider such as Anthropic, OpenAI, Google AI Studio, Azure OpenAI, or AWS Bedrock.
-
An API endpoint URL and API key for your provider of choice.
-
Ollama installed locally for offline operation without cloud API costs, providing its own local API endpoint. Download Ollama from ollama.com.
You configure your provider credentials in Step 2: Configure Your LLM Provider after installation. Any of the providers listed above works. The tutorial uses LiteLLM as an example, but the steps are similar for all providers.
Download and Install Agent Mesh
Solace Agent Mesh is available for Windows, macOS, and Linux. Log in to the Solace Products website, select Products, select Agent_Mesh, then Enterprise, and select the release you want to install. From the release contents, download the desktop installer for your operating system from the Desktop folder.
The installer includes two components:
- Solace Agent Mesh Desktop — Use Desktop to build and test agents interactively. Desktop is designed for evaluation, prototyping, and personal productivity. Launch it from your applications menu or desktop shortcut.
- Solace Agent Mesh CLI — Use the CLI to deploy what you build to production. Run
samfrom any terminal to push configurations to team or production environments. The CLI communicates with any instance of Solace Agent Mesh, including your Desktop instance. For more information, see CLI Reference.
Follow the installation steps for your operating system:
- Windows — Download the
.exeinstaller (for example,solace-agent-mesh-<version>-desktop-windows-x64.exe). Run the installer. It installs to your user folder and does not require administrator privileges.If Windows SmartScreen shows a "Windows protected your PC" warning, click More info.
Click Run anyway.
This warning is expected for newly released software.
- macOS — Download the
.dmgfile for your Mac's processor type, Apple Silicon or Intel (for example,solace-agent-mesh-<version>-desktop-macos-intel.dmg). Open the.dmgand drag Solace Agent Mesh to your Applications folder. - Linux (Experimental) — Linux support is in the Experimental stage. Solace Agent Mesh ships a Debian package (
.deb), an RPM package (.rpm), and a portable archive (.tar.gz), each built for one of two WebKitGTK versions. Check which version your distribution provides.On Debian or Ubuntu, run:
apt-cache policy libwebkit2gtk-4.1-0 libwebkit2gtk-4.0-37
On Fedora, RHEL, Rocky Linux, or AlmaLinux, run:
dnf list webkit2gtk4.1 webkit2gtk3
Then download and install the package that matches your distribution, architecture, and WebKitGTK version (for example,
solace-agent-mesh-<version>-desktop-linux-<arch>-webkit2gtk-<abi>.deb). On Debian or Ubuntu, run:sudo apt install ./solace-agent-mesh-<version>-desktop-linux-<arch>-webkit2gtk-<abi>.deb
On Fedora, RHEL, Rocky Linux, or AlmaLinux, run:
sudo dnf install ./solace-agent-mesh-<version>-desktop-linux-<arch>-webkit2gtk-<abi>.rpm
Next, you configure Agent Mesh.
Tutorial Steps
You've completed the first step in the tutorial. Click Next Lesson to continue.
| Step | Description |
|---|---|
|
|
Install Solace Agent Mesh - Complete |
|
|
Configure Your LLM Provider - Next Lesson |
|
|
Build Multi-Agent Orchestration |
|
|
Add a Connector |
|
|
Create a Workflow |
|
|
Test Agent Competence with Evaluations |
|
|
Add an Entrypoint |
|
|
Next Steps |
You can return to the main Tutorial page at any time.