ada3713e77
- 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
1.6 KiB
1.6 KiB
sidebar_position, title, description
| sidebar_position | title | description |
|---|---|---|
| 3 | Discord | Set up Hermes Agent as a Discord bot |
Discord Setup
Connect Hermes Agent to Discord to chat with it in DMs or server channels.
Setup Steps
- Create a bot: Go to the Discord Developer Portal
- Enable intents: Bot → Privileged Gateway Intents → enable Message Content Intent
- Get your user ID: Enable Developer Mode in Discord settings, right-click your name → Copy ID
- Invite to your server: OAuth2 → URL Generator → scopes:
bot,applications.commands→ permissions: Send Messages, Read Message History, Attach Files - Configure: Run
hermes gateway setupand select Discord, or add to~/.hermes/.envmanually:
DISCORD_BOT_TOKEN=MTIz...
DISCORD_ALLOWED_USERS=YOUR_USER_ID
- Start the gateway:
hermes gateway
Optional: Home Channel
Set a default channel for cron job delivery:
DISCORD_HOME_CHANNEL=123456789012345678
DISCORD_HOME_CHANNEL_NAME="#bot-updates"
Or use /sethome in any Discord channel.
Required Bot Permissions
When generating the invite URL, make sure to include:
- Send Messages — bot needs to reply
- Read Message History — for context
- Attach Files — for audio, images, and file outputs
Voice Messages
Voice messages on Discord are automatically transcribed (requires VOICE_TOOLS_OPENAI_KEY). TTS audio is sent as MP3 file attachments.
Security
:::warning
Always set DISCORD_ALLOWED_USERS to restrict who can use the bot. Without it, the gateway denies all users by default.
:::