Hermes Agent is an AI-powered coding agent that helps you automate tasks, write code, and interact with AI models directly through your preferred messaging platform. Instead of juggling multiple tools and manual workflows, Hermes brings your AI provider and messaging channels together in one place, so you can build and ship faster.

Deploying Hermes Agent traditionally means setting up servers, managing dependencies, and configuring environments yourself. xCloud eliminates all of that with fully managed hosting, handling the infrastructure so you can focus on what actually matters.

Follow this guide to deploy Hermes Agent on xCloud in minutes, connect your preferred AI provider, and optionally set up Telegram for messaging.

Built-In Support For AI Providers #

• Anthropic – API Key
• OpenAI API Key
• OpenRouter – API Key
• OpenAI – API Key
• Gemini – API Key

Built-in support for messaging channels from xCloud #

• Telegram

Step 1: Create an xCloud Managed Server  #

First, visit this link to start creating an xCloud managed server. Go to the ‘Server Name’ field and enter your server name. Then add a tag for the server. This step is optional and not mandatory.

Note: If you haven’t signed up yet, you will be prompted to create an account, choose a plan based on your preferences, and then proceed to payment.

Note: If you create an xCloud Managed Server using the standard server creation flow, choose “Agentic” as the web server, then select “Hermes Agent.” xCloud will then display the configuration options for deploying Hermes Agent.

Next, go to the ‘Server Type’ option. Here, xCloud provides two types of servers. One is ‘General’, and the other one is ‘Premium’.

• General servers are cost-effective servers powered by Intel CPUs and regular SSDs.
• On the other hand, premium servers are blazing fast with quicker 3 GHz+ Intel Xeon CPUs, faster memory, and NVMe storage.

After that, go to the ‘Server Size’ option and choose your preferred server size. Please note that deploying a Hermes Agent instance requires a minimum 4 GB RAM server.

Next, choose your preferred continent from the dropdown menu. Then select the server location within that region.

After that, choose your ‘Ubuntu version’ from the dropdown menu under the ‘Ubuntu Operating System’. You can also enable or disable backups for this application.

xCloud provides a separate stack for this application. You will see the ‘Hermes’ stack already selected.

Next, go to the security warning section, read the information carefully, and click on the checkbox to confirm that you have read and understood it.

Enter Your LLM Provider Credentials #

After that, go to the ‘AI provider’ section. Select your preferred AI model from the dropdown list under ‘AI Provider’, such as ‘OpenAI Codex’ or ‘OpenAI API’. Then enter the API token for the selected AI model.

OpenAI Codex – API Key:  #

To use your OpenAI account, choose ‘OpenAI Codex – ChatGPT 0Auth)’ from the ‘AI Provider’ menu, connect your account and enter the OAuth Token into the blank field. Also, you can set your ‘Default Model’ from the dropdown menu.

👉Read the step-by-step guide to connect OpenAI Codex with Hermes on xCloud

OpenAI – API Key:  #

To use OpenAI, choose ‘OpenAI – API KEY’ from the ‘AI Provider‘ menu and enter the OpenAI API key into the blank field. Then set your ‘Default Model’ from the dropdown menu.

Anthropic – API Key:  #

To use Anthropic, choose ‘Anthropic’ from the ‘AI Provider‘ menu and enter the Ahtropic API key into the blank field. Then set your ‘Default Model’ from the dropdown menu.

Google Gemini – API Key:  #

To use Gemini, choose ‘Google Gemini’ from the ‘AI Provider‘ menu and enter the Google Gemini API key into the blank field. Then set your ‘Default Model’ from the dropdown menu.

Likewise, xCloud provides Z AI, OpenRouter LLM provider as well. Set up your preferred LLM provider according to your preferences.

Set up Your Messaging Platform (Optional) #

Right now, xCloud allows you to connect to one built-in messaging platform: ‘Telegram’. Go to the section, add the ‘Bot token’ in the ‘Telegram Bot Token Field and ‘Telegram User ID’ in the respective fields, and click on the ‘Next’ button.

When you provide your Telegram User ID during setup, your account is automatically allowed to be listed with smarter auto-pairing. No need to run commands to pair your account!

Finally, click on the ‘Create’ button to proceed. This action will start creating the xCloud managed server and deploying the Hermes Agent application.

Manage the Configurations from the xCloud Dashboard #

Once the server is created, you will be redirected to the xCloud Hermes Agent dashboard. Here you will get options for ‘Status’, ‘Providers’, ‘Channels’, ‘Domain & SSL’, ‘Basic Auth’, ‘Monitoring’, Logs’, ‘SSH Access’, and ‘Settings’.

Log in to the Hermes Agent Dashboard #

To log in to your Hermes Agent account, go to the ‘Status from the dashboard. Collect the credentials ‘URL’ from the dashboard. Here you will also get a ‘Webhook Base’ URL as well.

Then go to the ‘Basic Auth Credentials’ Section and collect the ‘Basic Auth User’ and ‘Basic Auth Password’. 

After collecting all the credentials, log in to the Hermeas agent’s dashboard  the ‘Control UI URL’, ‘Basic Auth User’ and ‘Basic Auth Password’.

Hermes does not provide a chat box in its UI. You need to use the terminal, or you can connect your AI provider to chat with the Hermes Agent.

How To Update Default LLM Provider Settings #

In xCloud, you can also update the default LLM provider settings in the dashboard. Go to ‘Providers’ from the left side panel and navigate to the ‘Change Provider’ section. Add your ‘AI Provider’ and the ‘API Key’ and click on the ‘Save Changes’ button.

How to Add or Update Messaging Channels #

Similarly, you can add or update your messaging channels. If you haven’t connected your messaging channels with the Hermes Agent or want to update your existing channel, go to ‘Channels’ from the left side panel to add or update your ‘Telegram Bot Token’ and ‘Telegram User ID’ easily. Click on the ‘Save Changes’ button when you are done.

And that’s it. This is how easily you can deploy Hermes Agent on xCloud. Hermes Agent deployment on xCloud removes the complexity of self-managed hosting and lets you focus on what matters most.

If you run into any issues during the deployment process, feel free to reach out to our support team.