Hermes Agent on Amazon Bedrock AgentCore
aws-samples/sample-host-hermesagent-on-amazon-bedrock-agentcore
AWS sample that deploys Hermes Agent on Bedrock AgentCore with per-user microVMs and chat channels
Hermes Agent on Amazon Bedrock AgentCore is an AWS sample that deploys Hermes Agent on Amazon Bedrock AgentCore with CDK. Each user session runs in its own Firecracker microVM, and Claude models are reached through Bedrock without an Anthropic API key.
What Hermes Agent on Amazon Bedrock AgentCore does
This AWS sample deploys Hermes Agent on Amazon Bedrock AgentCore, running each user session in its own Firecracker microVM with automatic scaling. Hermes runs unmodified inside AgentCore containers. A small patch in app/hermes/main.py swaps anthropic.Anthropic for anthropic.AnthropicBedrock, so Claude models are reached through Bedrock with SigV4 signing and AWS IAM credentials instead of an Anthropic API key.
Chat traffic from Telegram, Slack, Discord and Feishu (Lark) arrives through API Gateway and a router Lambda, while an optional ECS Fargate gateway handles the long-lived WeChat and Feishu WebSocket connections. The infrastructure is defined as nine CDK stacks deployed in phases with scripts/deploy.sh. It covers a VPC, Bedrock Guardrails, CloudWatch dashboards, scheduled cron invocations and token usage tracking, and memory and sessions persist in an S3-backed workspace.
Key features
- Per-user isolation with one Firecracker microVM per session
- Claude models through Amazon Bedrock with SigV4 auth and no Anthropic API key
- Telegram, Slack, Discord and Feishu via webhook, WeChat via an ECS gateway
- Nine CDK stacks deployed in phases with a deploy script
- S3-backed workspace for memory and sessions
- Bedrock Guardrails, CloudWatch observability and token usage monitoring
When to use it
- Running Hermes Agent as a serverless, per-user service on AWS
- Using Bedrock-hosted Claude models under IAM and Bedrock policies
- Serving a Hermes bot to a team over Telegram, Slack, Discord or Feishu
Who it is for: AWS users who want to host Hermes Agent on managed infrastructure instead of a single server.
How it fits with Hermes Agent
A deployment sample built specifically for Hermes Agent. The README says Hermes source code stays unchanged and the hermes-agent repository is included as a Git submodule.
How to install Hermes Agent on Amazon Bedrock AgentCore
These commands are copied from the project's README. Check the repository for the latest steps before you run them.
pip install -r requirements.txt
npm install
./scripts/deploy.sh allRequirements: An AWS account with Bedrock model access (Claude Sonnet or Opus), AWS CLI with credentials, Node.js 18+, Python 3.10+, Docker, and the AgentCore CLI
Note: It deploys several AWS services and needs an AWS account with Bedrock model access.
FAQ
What is Hermes Agent on Amazon Bedrock AgentCore?
It is an AWS sample that deploys Hermes Agent on Amazon Bedrock AgentCore using CDK. Each user gets an isolated Firecracker microVM, and Claude models run through Bedrock.
How do I install Hermes Agent on Amazon Bedrock AgentCore?
Clone the repository, create a Python virtual environment, then run pip install -r requirements.txt, npm install and ./scripts/deploy.sh all. The deploy script can also run phase by phase, and phase 4 adds the optional WeChat and Feishu gateway.
What do I need to run Hermes Agent on Amazon Bedrock AgentCore?
You need an AWS account with Bedrock access to Claude models, the AWS CLI configured with credentials, Node.js 18 or newer, Python 3.10 or newer, Docker and the AgentCore CLI.
Similar deployment for Hermes Agent
All deploymentOne-click PowerShell installer that sets up Hermes Agent and a web UI on Windows through WSL2
xmbshwll hermes-agent-dockerMinimal Docker image for Hermes Agent with persistent state and mini-swe-agent included
0xrsydn nix-hermes-agentNix package and NixOS module that runs Hermes Agent as a declaratively configured system service
Azure karsReference stack for running AI agents, including Hermes, in hardened per-agent Kubernetes sandboxes
metantonio Hermes WSL UbuntuGuide and setup scripts for running Hermes Agent with llama.cpp and Qwen3.5 on WSL2, Ubuntu and macOS
pengchengxia75-arch Hermes Agent WindowsWindows-native adaptation of Hermes Agent with a PowerShell installer and browser Web UI
Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop