---
title: "Cloud server with Hermes Agent"
sidebar_label: "Hermes Agent"
sidebar_position: 16
description: "How to create and run a cloud server with Hermes Agent"
---

import CreateServer from '@site/i18n/en/docusaurus-plugin-content-docs/current/_partials/cloud-servers/applications/create-server-for-ai.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'

# Cloud server with Hermes Agent

<HermesAgentDescription />

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

1. [Create a public floating IP address](#create-floating-ip).

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

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

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

### 1. Create a public floating IP address \{#create-floating-ip}

Create a public floating IP address so that the cloud server with Hermes Agent is accessible from the internet.

Use the [Create a public floating IP address](/cloud-servers/cloud-networks/public-floating-ip-addresses.mdx#create-public-floating-ip) section of the [Public floating IP addresses](/cloud-servers/cloud-networks/public-floating-ip-addresses.mdx) guide.

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

<CreateServer AppNameInPanel="Hermes Agent VM" MinConfig="2 vCPU, RAM от 4 ГБ and размером загрузочного диска от 25 ГБ" OptionalVolumes="Optional: add an additional" VolumeSize="Specify the size of the network disk in GB or TB" />

### 3. 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 floating IP address of the server. You can copy it in the [control panel](https://my.selectel.ru/): from the top menu, click **Products** → **Cloud Servers** → in the server card, click <CopyIcon /> next to the public floating IP address.

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

2. Start the interactive setup of Hermes Agent:

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

3. Select the 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. Leave the **Base URL** parameter unchanged — to do this, press **Enter**.

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

8. Select the execution environment **Docker - isolated container with configurable resources** and press **Enter**.

9. Optional: select services to communicate with the agent. To do this, select the checkbox in the service line.

   Services require additional configuration. You configure each service yourself.

10. Press **Enter**.

11. Optional: change the list of functions that the agent will have access to. To do this, select or clear the checkbox in the function line.

    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 page operation mode **Local Browser \[★ recommended · free] — Headless Chromium, no API key needed** and press **Enter**.

14. Leave the remaining parameters unchanged — to do this, select **Skip — keep defaults / configure later** and press **Enter**.

### 4. Start Hermes Agent \{#run-hermes-agent}

1. In a browser, open the page `http://<ip_address>`.

   Specify `<ip_address>` — the public floating IP address of the cloud server that you [created in step 1](#create-floating-ip).

2. Enter the username — `admin`.

3. Enter the password — server UUID. You can copy it in the [control panel](https://my.selectel.ru/): from the top menu, click **Products** → **Cloud Servers** → in the server card, click <CopyIcon /> next to the UUID.

4. Click **Log in**.

<Formbricks />
