Hermes Agent

Hermes Agent is an open-source AI agent running on a dedicated virtual machine in Yandex Cloud and interacting with the user through a web dashboard, Telegram, or a local CLI session over SSH.

The image provisions a ready-to-use Hermes Agent environment, configures Yandex AI Studio, and prepares persistent storage for configuration, sessions, and the agent workspace.

What the user gets

• A ready-to-use virtual machine with Hermes Agent preinstalled.
• A web dashboard that starts on the VM automatically and is reachable over an SSH tunnel.
• Automatic Yandex AI Studio model configuration.
• An option to bind a personal Telegram bot during installation.
• Persistent storage for ~/.hermes and the agent workspace.
• SSH access for manual configuration, diagnostics, and CLI usage.

Use cases

• A personal Telegram agent for work and daily tasks.
• VM-based task automation through Hermes local tools.
• Agent workflow experiments without manual environment setup.

1. Make sure the folder has at least one VPC subnet.
2. If you want Telegram to be bound during installation:
   • create a bot via @BotFather;
   • store the token in Yandex Lockbox under the bot-token key;
   • get your numeric Telegram user ID via @userinfobot, @Getmyid_bot, or a similar bot.
3. Open Cloud Apps, find Hermes Agent, and click Use.
4. Specify:
   • application name;
   • the LLM model to use;
   • Telegram mode: bind the bot immediately or skip auto-binding;
   • VPC subnet;
   • VM user name and public SSH key;
   • VM sizing parameters;
   • the IP address CIDR allowed to access SSH.
5. Wait until the deployment is completed.
6. If Telegram was enabled, you can start talking to your bot immediately.
7. To open the web dashboard:
   • run the port forwarding command ssh -N -L 9119:127.0.0.1:9119 <user name>@<VM public IP address> (the command with the actual values appears in the application outputs);
   • open http://localhost:9119 in your browser.
8. For manual SSH usage:
   • connect using the ssh_connection_string output;
   • Hermes configuration will be in ~/.hermes;
   • the agent workspace will be in ~/workspace.
9. If Telegram was skipped during installation, configure it later through hermes gateway after connecting over SSH.

• A personal Telegram agent for accessing AI tools from chat.
• Routine task automation on a dedicated VM.
• Fast start with Hermes Agent in an isolated cloud environment.

Yandex Cloud technical support is available 24/7. The types of requests you can submit and the appropriate response time depend on your pricing plan. You can switch to the paid support plan in the management console. Learn more about technical support terms.

Yandex Cloud does not provide technical support for Hermes Agent itself. For product-specific issues, use the developer documentation and repository.