Skip to main content
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. ORIV 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 ORIV 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 ORIV

  • Telegram

Step 1: Create an ORIV Managed Server

First, visit this link to start creating an ORIV 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] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Note: If you create an ORIV Managed Server using the standard server creation flow, choose “Agentic” as the web server, then select “Hermes Agent.” ORIV will then display the configuration options for deploying Hermes Agent.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Next, go to the ‘Server Type’ option. Here, ORIV 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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Next, choose your preferred continent from the dropdown menu. Then select the server location within that region.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
ORIV provides a separate stack for this application. You will see the ‘Hermes’ stack already selected.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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 ORIV
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Likewise, ORIV 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, ORIV 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!
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Finally, click on the ‘Create’ button to proceed. This action will start creating the ORIV managed server and deploying the Hermes Agent application.

Manage the Configurations from the ORIV Dashboard

Once the server is created, you will be redirected to the ORIV Hermes Agent dashboard. Here you will get options for ‘Status’, ‘Providers’, ‘Channels’, ‘Domain & SSL’, ‘Basic Auth’, ‘Monitoring’, Logs’, ‘SSH Access’, and ‘Settings’.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
Then go to the ‘Basic Auth Credentials’ Section and collect the ‘Basic Auth User’ and ‘Basic Auth Password’.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
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 ORIV, 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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.

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.
[!NOTE] Precisa de ajuda visual para esta etapa? Entre em contato com o nosso suporte em support@oriv.cloud.
And that’s it. This is how easily you can deploy Hermes Agent on ORIV. Hermes Agent deployment on ORIV 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.