| name: irc-platform |
| label: IRC |
| kind: platform |
| version: 1.0.0 |
| description: > |
| IRC gateway adapter for Hermes Agent. |
| Connects to an IRC server and relays messages between an IRC channel |
| (or DMs) and the Hermes agent. No external dependencies — uses |
| Python's stdlib asyncio for the IRC protocol. |
| author: Nous Research |
| |
| |
| requires_env: |
| - name: IRC_SERVER |
| description: "IRC server hostname (e.g. irc.libera.chat)" |
| prompt: "IRC server" |
| password: false |
| - name: IRC_CHANNEL |
| description: "Channel to join (e.g. #hermes — comma-separate for multiple)" |
| prompt: "IRC channel" |
| password: false |
| - name: IRC_NICKNAME |
| description: "Bot nickname on IRC (default: hermes-bot)" |
| prompt: "Bot nickname" |
| password: false |
| optional_env: |
| - name: IRC_PORT |
| description: "IRC server port (default: 6697 with TLS, 6667 without)" |
| prompt: "IRC port" |
| password: false |
| - name: IRC_USE_TLS |
| description: "Use TLS for the IRC connection (1/true/yes to enable, default: true on port 6697)" |
| prompt: "Use TLS? (true/false)" |
| password: false |
| - name: IRC_SERVER_PASSWORD |
| description: "Server password for the IRC PASS command (optional)" |
| prompt: "Server password (optional)" |
| password: true |
| - name: IRC_NICKSERV_PASSWORD |
| description: "NickServ password for automatic IDENTIFY on connect (optional)" |
| prompt: "NickServ password (optional)" |
| password: true |
| - name: IRC_ALLOWED_USERS |
| description: "Comma-separated IRC nicks allowed to talk to the bot" |
| prompt: "Allowed nicks (comma-separated)" |
| password: false |
| - name: IRC_ALLOW_ALL_USERS |
| description: "Allow anyone in the channel to talk to the bot (dev only)" |
| prompt: "Allow all users? (true/false)" |
| password: false |
| - name: IRC_HOME_CHANNEL |
| description: "Channel for cron / notification delivery (defaults to IRC_CHANNEL)" |
| prompt: "Home channel (or empty)" |
| password: false |
|
|
