Home

IRCX Wiki

A full IRCv3 platform adapter for Hermes Agent, built on irctokens + ircstates.

Repo: computator1200/hermes-ircx-plugin · Platform name: ircx

📚 Pages

• Chat Commands - .agent (model/memory/reasoning) and .ircx (live adapter config) prefixes, plus the ircx.env config file.
• Configuration - every IRCX_* env var, config.yaml schema, per-channel groups, precedence.
• Interactive Behaviours - observe-mode spontaneous replies, runtime channel-agency tools, downtime context persistence.
• Authentication and SASL - the verified-account identity model, SASL mechanisms, allowlists, hardening.
• Troubleshooting - connect / join / reply / reconnect issues and fixes.

60-second start

# 1. dependencies (into the env your Hermes gateway runs from)
<hermes-venv>/bin/python -m pip install irctokens ircstates

# 2. install the plugin
cp -r plugins/platforms/ircx ~/.hermes/plugins/ircx

# 3. minimal config (~/.hermes/.env)
IRCX_SERVER=irc.libera.chat
IRCX_CHANNEL=#yourchannel
IRCX_NICKNAME=hermes-bot
IRCX_SASL_MECHANISM=PLAIN
IRCX_SASL_USERNAME=hermes
IRCX_SASL_PASSWORD=...
IRCX_ALLOWED_USERS=youraccount

Restart the gateway. In a channel, address the bot by nick (hermes-bot: hello) and it replies.

What you get

Area	What you get
Protocol	Full IRCv3 CAP negotiation; only ACKed caps used
Auth	SASL PLAIN / EXTERNAL / SCRAM-256 / SCRAM-512; verified-account authorization
Resilience	Flood protection, keepalive + ping-timeout, gateway-driven reconnect (rejoin + re-auth)
Context	draft/chathistory backfill + on-disk logging tail-replay across disconnects
Agency	irc_join / irc_part / irc_say / irc_list_channels tools, opt-in + allowlisted
Presence	Observe-mode spontaneous contribution with probability + cooldown

Not affiliated with or endorsed by Nous Research.