---
title: "Hermes Agent Virtual Machine"
sidebar_label: "Hermes Agent Virtual Machine"
sidebar_position: 16
description: "How to create and run a cloud server with Hermes Agent via the AI Marketplace"
---

import CreateServer from '@site/i18n/en/docusaurus-plugin-content-docs/current/_partials/ai-marketplace/create-server.mdx'
import {CustomTable} from '@selectel/docux/components'
import CopyIcon from '@selectel/docux/icons/copy'
import MoreVerticalIcon from '@selectel/docux/icons/more-vertical'
import Formbricks from '@theme/MDXComponents/Formbricks'
import HermesAgentDescription from '@site/i18n/en/docusaurus-plugin-content-docs/current/_partials/ai-marketplace/hermes-agent.mdx'

# Hermes Agent virtual machine

<HermesAgentDescription />

## Get started with Hermes Agent Virtual Machine \{#getting-started-with-hermes-agent}

1. [Create a cloud server with Hermes Agent](#create-cloud-server-with-hermes-agent).

2. [Configure Hermes Agent](#configure-hermes-agent).

3. [Run Hermes Agent](#run-hermes-agent).

### 1. Create a cloud server with Hermes Agent \{#create-cloud-server-with-hermes-agent}

<CreateServer SourceNameInPanel="Hermes Agent VM (Ubuntu 24.04 LTS 64-bit)" OptionalGpuForList="optional: " OptionalGpuForTitle="Optional: " slug="hermes-agent" />

### 2. Configure Hermes Agent \{#configure-hermes-agent}

1. Connect to the cloud server with Hermes Agent:

   1.1.Open the CLI.

   1.2.Connect to the cloud server:

   ```bash
   ssh root@<ip_address>
   ```

   Specify `<ip_address>` — the public IP address of the server. You can copy it in the [control panel](https://my.selectel.ru/ml/default/ai-marketplace): from the top menu, click **Products** → **AI Marketplace** → in the server card, click <CopyIcon /> next to the public IP address.

   1.3.If you do not have an [SSH key pair](/cloud-servers/manage/create-and-place-ssh-key.mdx), enter the `root` user password. You can copy it in the [control panel](https://my.selectel.ru/ml/default/ai-marketplace): from the top menu, click **Products** → **AI Marketplace** → server page → **Console** tab → in the **Password** field, click <CopyIcon />.

2. Start the interactive Hermes Agent configuration:

   ```bash
   docker exec -it hermes hermes setup
   ```

3. Select a setup method **Full setup — configure every provider, tool & option yourself (bring your own keys)** and press **Enter**.

4. Select a model provider and press **Enter**.

5. Enter the provider's API key and press **Enter**.

6. Keep the **Base URL** as is — to do this, press **Enter**.

7. Select a model and press **Enter**.

8. Select a runtime environment **Docker - isolated container with configurable resources** and press **Enter**.

9. Optional: select services for agent communication. To do this, check the box in the service row.

   Services require additional configuration. You configure each service yourself.

10. Press **Enter**.

11. Optional: change the list of functions accessible to the agent. To do this, check or uncheck the box in the function row.

    Some functions (for example, video analysis or generation) require additional configuration or specific models. You configure each function yourself.

12. Press **Enter**.

13. Select the agent's web browsing mode **Local Browser \[★ recommended · free] — Headless Chromium, no API key needed** and press **Enter**.

14. Keep the rest of the parameters as is — to do this, select **Skip — keep defaults / configure later** and press **Enter**.

### 3. Run Hermes Agent \{#run-hermes-agent}

1. In the [control panel](https://my.selectel.ru/ml/default/ai-marketplace), from the top menu, click **Products** and select **AI Marketplace**.

2. In the Hermes Agent Virtual Machine card, click **Go to GUI**.

3. Enter the username — `admin`.

4. Enter the password — the server UUID. You can copy it in the [control panel](https://my.selectel.ru/ml/default/ai-marketplace): from the top menu, click **Products** → **AI Marketplace** → in the server <MoreVerticalIcon /> menu, select **Copy UUID**.

5. Click **Sign in**.

<Formbricks />