{"id":40357,"date":"2026-11-18T14:47:00","date_gmt":"2026-11-18T07:47:00","guid":{"rendered":"https:\/\/cloudraya.com\/?p=40357"},"modified":"2026-11-18T15:50:04","modified_gmt":"2026-11-18T08:50:04","slug":"hermes-agent-is","status":"publish","type":"post","link":"https:\/\/cloudraya.com\/en\/blog\/hermes-agent-is\/","title":{"rendered":"How to Install Hermes Agent on a VPS: Step-by-Step Guide"},"content":{"rendered":"<p><span data-contrast=\"auto\">If you think AI is only useful for answering questions and helping you get things done, it's time to discover Hermes Agent!<\/span> <\/p>\n<p><span data-contrast=\"auto\">Hermes Agent does more than answer questions. It can remember context, learn from your interactions, and help carry out tasks more independently.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Think of it as your personal office assistant, but powered by AI and running on your own VPS.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Curious to see what it can do? Let's explore how to install Hermes Agent on a VPS. But first, let's get to know this AI assistant and what makes it different.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"what-is-hermes-agent\"><b><span data-contrast=\"none\">What Is Hermes Agent?<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">Hermes Agent is an autonomous AI agent developed by Nous Research.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Unlike traditional chatbots that mainly respond to individual prompts, Hermes is designed to help you handle daily tasks using various tools. It can also store memories and improve its capabilities based on previous interactions and tasks.<\/span> <\/p>\n<p><span data-contrast=\"auto\">This means you don't have to keep repeating instructions or explaining the same context from scratch. Let's take a closer look at its key features:<\/span> <\/p>\n<ul>\n<li><b><span data-contrast=\"auto\">Persistent Memory:<\/span><\/b><span data-contrast=\"auto\"> Remembers your information and preferences to maintain context across sessions.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">Self-Improving Skills:<\/span><\/b><span data-contrast=\"auto\"> Creates and improves skills based on the instructions and tasks you give it.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">Tool Integration:<\/span><\/b><span data-contrast=\"auto\"> Uses various tools, including web search, browser automation, and file processing.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">Scheduled Tasks:<\/span><\/b><span data-contrast=\"auto\"> Runs tasks on a schedule without requiring a new prompt every time.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">Messaging Integration:<\/span><\/b><span data-contrast=\"auto\"> Connects with platforms like Telegram, Discord, and Slack for easier interaction.<\/span> <\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">With these features, you can use Hermes Agent as a personal AI assistant, research assistant, or even as part of your workflow automation.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"where-can-you-run-hermes-agent\"><b><span data-contrast=\"none\">Where Can You Run Hermes Agent?<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">You don't need a dedicated server or a high-end computer to get started with Hermes Agent.<\/span> <\/p>\n<p><span data-contrast=\"auto\">It can run in several different environments, including:<\/span> <\/p>\n<ul>\n<li aria-setsize=\"-1\" data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"11\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"1\" data-aria-level=\"1\">\n<h3 id=\"personal-computer\"><span data-contrast=\"none\">Personal Computer<\/span> <\/h3>\n<\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">Hermes supports Linux, macOS (Apple Silicon), and Windows 10\/11. On Windows, you can also use WSL2 if you prefer running it in a Linux environment.<\/span> <\/p>\n<ul>\n<li aria-setsize=\"-1\" data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"11\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"2\" data-aria-level=\"1\">\n<h3 id=\"vps-or-cloud-server\"><span data-contrast=\"none\">VPS or Cloud Server<\/span> <\/h3>\n<\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">A VPS or cloud server is generally more suitable if you want Hermes to stay accessible from other platforms without depending on your personal computer.<\/span> <\/p>\n<ul>\n<li aria-setsize=\"-1\" data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"11\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"3\" data-aria-level=\"1\">\n<h3 id=\"docker-container\"><span data-contrast=\"none\">Docker Container<\/span> <\/h3>\n<\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">Docker is another option if you want to run Hermes in an isolated environment that's easier to manage.<\/span> <\/p>\n<ul>\n<li aria-setsize=\"-1\" data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"11\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" data-aria-posinset=\"4\" data-aria-level=\"1\">\n<h3 id=\"android-termux\"><span data-contrast=\"none\">Android (Termux)<\/span> <\/h3>\n<\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">Hermes also supports Android devices with ARM64 architecture through Termux. However, some features may have limitations or require additional configuration to work properly.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"what-server-specifications-do-you-need\"><b><span data-contrast=\"none\">What Server Specifications Do You Need?<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">Hermes' resource requirements depend on the complexity of your tasks and the tools you use.<\/span> <\/p>\n<p><span data-contrast=\"auto\">If you connect Hermes to an API provider such as OpenAI or OpenRouter, your VPS doesn't need to run the AI model itself. The server only needs enough resources to run Hermes and its required tools.<\/span> <\/p>\n<p><span data-contrast=\"auto\">In other words, you don't need a VPS with a dedicated GPU. Here's a general recommendation based on different usage scenarios:<\/span> <\/p>\n<table data-tablestyle=\"MsoTableGrid\" data-tablelook=\"1184\" aria-rowcount=\"4\" aria-colcount=\"2\">\n<tbody>\n<tr aria-rowindex=\"1\">\n<td data-celllook=\"0\"><b><span data-contrast=\"auto\">Usage<\/span><\/b> <\/td>\n<td data-celllook=\"0\"><b><span data-contrast=\"auto\">Recommended Resources<\/span><\/b> <\/td>\n<\/tr>\n<tr aria-rowindex=\"2\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Personal use and light automation<\/span> <\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">2 vCPU, 4 GB RAM<\/span> <\/td>\n<\/tr>\n<tr aria-rowindex=\"3\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Regular use with multiple tools<\/span> <\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">4 vCPU, 8 GB RAM<\/span> <\/td>\n<\/tr>\n<tr aria-rowindex=\"4\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Browser automation and heavier workloads<\/span> <\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">4\u20138 vCPU, 8\u201316 GB RAM<\/span> <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><span data-contrast=\"auto\">Keep in mind that these specifications are starting recommendations, not Hermes' official minimum requirements. Browser automation, file processing, and running multiple tasks simultaneously may require additional resources.<\/span> <\/p>\n<p><span data-contrast=\"auto\">If you only want to try Hermes, use it as a personal AI assistant, or run simple automation tasks, a VPS with 2 vCPU and 4 GB RAM is a reasonable starting point.<\/span> <\/p>\n<p><span data-contrast=\"auto\">However, running an AI model locally on your server is a different story. You'll need significantly more resources, especially GPU power and VRAM.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Once you've chosen the right environment, you're ready to prepare your VPS and install Hermes Agent.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"what-you-need-before-installing-hermes-agent\"><b><span data-contrast=\"none\">What You Need Before Installing Hermes Agent<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">Before getting started, make sure you have the following:<\/span> <\/p>\n<ul>\n<li><b><span data-contrast=\"auto\">Linux VPS:<\/span><\/b><span data-contrast=\"auto\"> Prepare a VPS running a compatible Linux distribution, such as Ubuntu.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">SSH Access:<\/span><\/b><span data-contrast=\"auto\"> Have your server's IP address, username, and login credentials ready.<\/span> <\/li>\n<li><b><span data-contrast=\"auto\">Internet Connection:<\/span><\/b><span data-contrast=\"auto\"> Make sure your server has an active internet connection to download the installer and required dependencies.<\/span> <\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">For this tutorial, we'll use Ubuntu on a VPS to make the installation and server configuration easier to follow.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"how-to-install-hermes-agent-on-a-vps\"><b><span data-contrast=\"none\">How to Install Hermes Agent on a VPS<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">Once your Linux VPS is ready, you can start installing Hermes Agent through SSH.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Follow these steps to complete the installation and initial configuration.<\/span><\/p>\n<h3 id=\"1-connect-to-your-vps-via-ssh\">1. Connect to Your VPS via SSH<\/h3>\n<p><span data-contrast=\"auto\">Open a terminal on your computer and connect to your VPS using its IP address and username.<\/span> <\/p>\n<pre><span data-contrast=\"auto\">ssh username@IP-VPS<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Replace <\/span><span data-contrast=\"auto\">username<\/span><span data-contrast=\"auto\"> and <\/span><span data-contrast=\"auto\">IP-VPS<\/span><span data-contrast=\"auto\"> with your actual server credentials.<\/span><\/p>\n<h3 id=\"2-check-the-installation-requirements\">2. Check the Installation Requirements<\/h3>\n<p><span data-contrast=\"auto\">Make sure Git, curl, and xz-utils are available on your server. On Ubuntu, run:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">sudo apt update<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<pre><span data-contrast=\"auto\">sudo apt install -y git curl xz-utils<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">The official Hermes installer will automatically prepare other dependencies, including Python, Node.js, npm, ripgrep, FFmpeg, and the required environment. This means you don't have to install everything manually.<\/span><\/p>\n<h3 id=\"3-run-the-hermes-agent-installer\">3. Run the Hermes Agent Installer<\/h3>\n<p><span data-contrast=\"auto\">Use the following command to download and run the official Hermes Agent installer:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">curl -fsSL https:\/\/hermes-agent.nousresearch.com\/install.sh | bash<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Wait for the installation to finish. The installer will set up the source code, dependencies, and Hermes command so you can run it directly from your terminal.<\/span><\/p>\n<h3 id=\"4-reload-your-shell-and-launch-hermes-agent\">4. Reload Your Shell and Launch Hermes Agent<\/h3>\n<p><span data-contrast=\"auto\">Once the installation is complete, reload your shell configuration so the Hermes command becomes available.<\/span> <\/p>\n<pre><span data-contrast=\"auto\">source ~\/.bashrc<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Then, run:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">hermes<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">If the installation is successful, Hermes Agent will launch, and you can start interacting with it through your terminal.<\/span><\/p>\n<h3 id=\"5-configure-your-ai-provider\">5. Configure Your AI Provider<\/h3>\n<p><span data-contrast=\"auto\">Before using Hermes Agent, you need to connect it to an AI model from your preferred provider.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Run the configuration wizard:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">hermes setup<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Follow the prompts to select a provider and enter the required credentials, such as your API key.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Alternatively, if you prefer a simpler setup through Nous Portal, you can run:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">hermes setup --portal<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Choose the configuration method that works best for your preferred provider. Once everything is set up, try sending a message through Hermes to make sure the AI model is connected.<\/span><\/p>\n<h3 id=\"6-connect-hermes-agent-to-messaging-platforms\">6. Connect Hermes Agent to Messaging Platforms<\/h3>\n<p><span data-contrast=\"auto\">If you want to interact with Hermes Agent through Telegram, Discord, or Slack, you'll need to configure its messaging gateway.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Run:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">hermes gateway setup<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Follow the instructions to select a platform and connect the required account or bot. Once the configuration is complete, you can set up the gateway to run as a background service.<\/span><\/p>\n<h3 id=\"7-run-the-gateway-as-a-background-service\">7. Run the Gateway as a Background Service<\/h3>\n<p><span data-contrast=\"auto\">To keep Hermes Agent available for incoming messages and scheduled tasks without leaving your terminal open, install the gateway as a system service on Linux.<\/span> <\/p>\n<p><span data-contrast=\"auto\">On your VPS, run:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">sudo hermes gateway install --system<\/span><span data-ccp-props=\"{}\">\u00a0<\/span>\r\n\r\n<span data-contrast=\"auto\">sudo hermes gateway start --system<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">Check the gateway status with:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">sudo hermes gateway status --system<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">If the status shows that the service is running, your gateway is active. You can also check the logs to monitor its activity and troubleshoot potential issues.<\/span><\/p>\n<h3 id=\"8-check-your-hermes-agent-installation\">8. Check Your Hermes Agent Installation<\/h3>\n<p><span data-contrast=\"auto\">Finally, run the following command to check your installation and configuration:<\/span> <\/p>\n<pre><span data-contrast=\"auto\">hermes doctor<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/pre>\n<p><span data-contrast=\"auto\">This command helps identify potential issues with your environment, dependencies, or Hermes Agent configuration. If any problems are detected, follow the suggested fixes.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Once everything is running smoothly, your Hermes Agent is ready to help you with your daily tasks!<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"deploy-hermes-agent-more-easily-through-cloudraya-marketplace\"><b><span data-contrast=\"none\">Deploy Hermes Agent More Easily Through CloudRaya Marketplace<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">For users who aren't familiar with server management, installing Hermes Agent manually might feel a little complicated. The good news is that you can get started more easily through CloudRaya Marketplace.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Hermes Agent is available on CloudRaya Marketplace as a fully managed serverless container. This means you don't need to prepare a VPS, configure the environment, or run installation commands yourself.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Once deployment is complete, you can access the Hermes Agent dashboard directly through your browser.<\/span> <\/p>\n<p><span data-contrast=\"auto\">So, if you'd rather skip the technical setup and focus on using your AI assistant, CloudRaya Marketplace offers a more convenient way to get started.<\/span> <\/p>\n<h2 aria-level=&quot;2&quot; id=\"conclusion\"><b><span data-contrast=\"none\">Conclusion<\/span><\/b> <\/h2>\n<p><span data-contrast=\"auto\">Hermes Agent gives you a more capable AI assistant to help with everyday tasks. You can run it on your own server, such as a VPS, or even on your personal computer.<\/span> <\/p>\n<p><span data-contrast=\"auto\">And if you'd rather skip the manual setup, you can deploy Hermes Agent more easily through CloudRaya Marketplace.<\/span> <\/p>\n<p><span data-contrast=\"auto\">Ready to build your own AI assistant? <a href=\"http:\/\/panel.cloudraya.com\">Sign up<\/a> for CloudRaya today!<\/span> <\/p>\n<p> <\/p>\n","protected":false},"excerpt":{"rendered":"<p>If you think AI is only useful for answering questions and helping you get things done, it's time to discover Hermes Agent! Hermes Agent does more than answer questions. It can remember context, learn from your interactions, and help carry out tasks more independently. Think of it as your personal office assistant, but powered by [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":40358,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[136],"tags":[],"class_list":["post-40357","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cloud-insight","post-wrapper"],"acf":{"reading_time":"","featured_article":false},"_links":{"self":[{"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/posts\/40357","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/comments?post=40357"}],"version-history":[{"count":2,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/posts\/40357\/revisions"}],"predecessor-version":[{"id":40361,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/posts\/40357\/revisions\/40361"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/media\/40358"}],"wp:attachment":[{"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/media?parent=40357"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/categories?post=40357"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cloudraya.com\/en\/wp-json\/wp\/v2\/tags?post=40357"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}