Setup
Create and configure a new Hermes project agent on XO.
Set up a Hermes agent on XO: name your project, supply your model and channel credentials, and open the dashboard to monitor your agent.
What You'll Need
- An XO account
- At least one model provider — an Anthropic API key, an OpenAI API key, or both
- At least one channel — a Telegram bot token (from @BotFather), a WhatsApp QR scan, or a Slack app token + bot token
Any combination of providers and channels works.
Deploy Hermes
Create a New Project
Go to beta.xo.builders.
Click the + icon next to My Projects in the left sidebar.
On the Hermes Agent template card, click Create Agent.
Configure Project Details
Fill in the project creation form:
| Field | Value |
|---|---|
| Project Name | A unique name — e.g. hermes-test (note this down, you'll need it for the dashboard URL) |
| Anthropic API Key | Your Anthropic API key |
| OpenAI API Key | Your OpenAI API key |
| Telegram Bot Token | Your token from @BotFather |
| Scan the QR code shown in the form | |
| Slack | Your Slack app token and bot token |
| Volume Size | Default 2 GB is fine for most setups |
At least one provider (Anthropic or OpenAI) and at least one channel (Telegram, WhatsApp, or Slack) are required.
Enter your Anthropic API Key in the API Key field.
Enter your Telegram Bot Token in the Bot Token field.
Click Create Project.
Wait for Startup
Your workspace takes 5–6 minutes to provision. The Hermes environment is being set up in the background.
Open the Configure panel to check logs and watch for readiness.
The agent is ready when Hermes Dashboard and Gateway appear in the Workspace Details sidebar.
Open the Hermes Dashboard
Once Hermes Dashboard appears in the sidebar, click it. The dashboard opens in a new tab.
Your agent is now live. Send it a message from your connected messaging app (Telegram, WhatsApp, or Slack), and monitor active conversations from the dashboard.
The Hermes Dashboard URL follows the pattern hermes-dashboard--<project-name>--<workspace-user>.workspace.helloxo.nl. The project name in the URL must match the name you set in Step 2.