Files

teknium1 ada3713e77 feat: add documentation website (Docusaurus)

- 25 documentation pages covering Getting Started, User Guide, Developer Guide, and Reference
- Docusaurus with custom amber/gold theme matching the landing page branding
- GitHub Actions workflow to deploy landing page + docs to GitHub Pages
- Landing page at root, docs at /docs/ on hermes-agent.nousresearch.com
- Content extracted and restructured from existing repo docs (README, AGENTS.md, CONTRIBUTING.md, docs/)
- Auto-deploy on push to main when website/ or landingpage/ changes

2026-03-05 05:24:55 -08:00

1.5 KiB

Raw Blame History

sidebar_position, title, description

sidebar_position	title	description
4	Slack	Set up Hermes Agent as a Slack bot

Slack Setup

Connect Hermes Agent to Slack using Socket Mode for real-time communication.

Setup Steps

Create an app: Go to Slack API, create a new app
Enable Socket Mode: In app settings → Socket Mode → Enable
Get tokens:
- Bot Token (xoxb-...): OAuth & Permissions → Install to Workspace
- App Token (xapp-...): Basic Information → App-Level Tokens → Generate (with connections:write scope)
Configure: Run hermes gateway setup and select Slack, or add to ~/.hermes/.env manually:

SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_ALLOWED_USERS=U01234ABCDE    # Comma-separated Slack user IDs

Start the gateway:

hermes gateway

Optional: Home Channel

Set a default channel for cron job delivery:

SLACK_HOME_CHANNEL=C01234567890

Required Bot Scopes

Make sure your Slack app has these OAuth scopes:

chat:write — Send messages
channels:history — Read channel messages
im:history — Read DM messages
files:write — Upload files (audio, images)

Voice Messages

Voice messages on Slack are automatically transcribed (requires VOICE_TOOLS_OPENAI_KEY). TTS audio is sent as file attachments.

Security

:::warning Always set SLACK_ALLOWED_USERS to restrict who can use the bot. Without it, the gateway denies all users by default. :::

1.5 KiB Raw Blame History