Easy Deploy Hermes using Debian 12

This guide walks you through deploying Hermes on a Linux Debian 12 VPS with 3 GB RAM, 2 CPU cores, and 40 GB disk.

Prerequisites

Install the required dependencies first:

apt install -y curl git tar software-properties-common build-essential
apt install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2

Step 1: Run the Official Installer

curl -fsSL https://nousresearch.com | bash

Wait for the process to complete. Once finished, reload your working environment. The installer will then prompt you to choose one of the following options:

  1. Quick Setup — free but limited
  2. Full Setup — configures every service provider and device, and uses your own access keys
  3. Blank Slate — all features disabled except the most essential ones

If you already have API keys, choose option 2. If you want to try it out first, choose option 1. In this case, we'll use option 2.

Step 2: Choose a Provider

Since we're using a custom LLM provider, select Custom. You'll then be asked to:

  1. Fill in the API base URL
  2. Enter your API key
  3. Choose 1 for Auto-detect
  4. Select your suitable AI models

Step 3: Set the Reasoning Effort Level

Choose the reasoning effort level. The higher the setting, the more tokens will be consumed. For most cases, medium is recommended.

Step 4: Choose a Platform

Select the platform you want to configure. Most people typically choose Telegram, email, or WhatsApp. Some additional steps may be required to sync with the related API account.

Step 5: Configure the CLI Device

You'll be asked to specify the CLI device to use. Leave it at the default setting.

Step 6: Choose a Search Engine

You'll also be asked to select a search engine option. Since we installed the additional Chromium libraries, choose Local.

When prompted to select a search engine provider, pick the one that best suits your environment.

Step 7: Reload Your Shell

Configuration is complete. Reload your shell to start using Hermes:

source ~/.bashrc

Step 8: Verify the Installation

Check the version to confirm everything is working:

hermes --version

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.