Hermes Agent Cloud: deployment tool for Hermes Agent

Wizard-first CLI that deploys Hermes Agent to AWS, GCP or Azure VMs with Terraform and cloud secret stores

What Hermes Agent Cloud does

Hermes Agent Cloud is a wizard-first command-line tool that deploys Hermes Agent to a cloud VM on AWS, GCP or Azure. The hermes-deploy CLI is written in Bash with gum for the interface and Terraform for infrastructure, and its preflight checks confirm that dependencies such as gum, terraform, jq and the cloud CLIs are present.

Each cloud has its own Terraform module: EC2 with a security group, IAM and SSM Parameter Store on AWS, a VM with a VNet, NSG, Key Vault and managed identity on Azure, and a core deploy plus capability packs on GCP. Secrets go to the cloud's secret store rather than plaintext. A bootstrap script on the VM installs Docker and Hermes, pulls secrets and sets up systemd, and a 7-point health check runs on the instance. Per-cloud commands cover status, ssh, logs, secrets and destroy, with a doctor command on GCP. The repository also holds a Next.js marketing website, and other VPS providers are listed on the roadmap.

Key features

Interactive deploy wizard for AWS, GCP and Azure
Terraform modules for EC2 and IAM, Azure VM and Key Vault, and GCP with capability packs
Secrets kept in SSM Parameter Store, Azure Key Vault or the GCP equivalent
VM bootstrap that installs Docker and Hermes and sets up systemd
Per-cloud status, ssh, logs, secrets and destroy commands
7-point on-instance health check

When to use it

Put a Hermes Agent on an always-on cloud VM without hand-writing infrastructure
Inspect logs or open an ssh session on a deployed agent from one CLI
Tear down a deployed agent and its cloud resources with a single command

Who it is for: Hermes Agent users who want a repeatable way to host the agent on AWS, GCP or Azure.

How it fits with Hermes Agent

Built to provision Hermes Agent on cloud VMs, rendering a Hermes config template at deploy time.

How to install Hermes Agent Cloud

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

curl -sSL https://raw.githubusercontent.com/unrealandychan/Hermes-Agent-Cloud/main/cli/install.sh | bash

Requirements: gum, terraform, jq and the CLI of your chosen cloud, which the preflight check looks for

Note: Support for other VPS providers is listed as a roadmap item, not as a current feature.

FAQ

What is Hermes Agent Cloud?

Hermes Agent Cloud is a command-line tool that deploys Hermes Agent to a VM on AWS, GCP or Azure through a guided wizard. It provisions the infrastructure with Terraform and stores secrets in the cloud's secret manager.

Does Hermes Agent Cloud work with Hermes Agent?

Yes, it exists to deploy Hermes Agent. The VM bootstrap installs Docker and Hermes, pulls secrets and sets up a systemd service, and a Hermes config template is rendered at deploy time.

How do I install Hermes Agent Cloud?

Run the install.sh script from the README with curl and bash, which detects macOS or Linux. The README recommends verifying the script first, and publishes SHA-256 checksums for each release.