Skip to content
Hermes documentation

Get started

Open the agent

You need AWS access, the AWS CLI and the Session Manager plugin.

Open browser chat

Section titled “Open browser chat”
  1. On your Mac, replace INSTANCE_ID and run:
aws ssm start-session \
  --region us-east-1 \
  --target INSTANCE_ID \
  --document-name AWS-StartPortForwardingSession \
  --parameters '{"portNumber":["9119"],"localPortNumber":["19119"]}'
  1. Leave that terminal open.
  2. Open localhost:19119/chat?profile=default and choose New chat.
Browser port 19119 connects through an authenticated AWS SSM tunnel to the EC2 dashboard on loopback port 9119. Keep the operator terminal open.
The tunnel provides private access; the dashboard stays on EC2 loopback.Open full size Mermaid source
Find the instance ID or refresh AWS sign-in
aws login
aws cloudformation describe-stacks \
  --stack-name MartianHermesAgent --region us-east-1 \
  --query "Stacks[0].Outputs[?OutputKey=='InstanceId'].OutputValue | [0]" \
  --output text

If port 19119 is busy, change localPortNumber and use that port in your browser.

Operator terminal

Section titled “Operator terminal”

On your Mac:

aws ssm start-session --region us-east-1 --target INSTANCE_ID

Then on EC2:

sudo -iu hermes
hermes chat

/quit returns to the shell. Your files live under /srv/hermes/workspace on EC2.

Next: Run your first test →