Skip to main content
Connect your Comis agent to IRC servers and channels. IRC is the simplest adapter — just point it at a server and join channels. Supports TLS encryption, NickServ authentication, and nick-based mentions. No file attachments and no Markdown/HTML formatting (only IRC control codes for bold and color).
You don’t need to understand the technical details to use this feature. The configuration examples below are copy-paste ready.

​
Prerequisites

  • An IRC server to connect to (e.g., irc.libera.chat, irc.oftc.net)
  • (Optional) A registered nickname on the server
IRC has a 512-character message limit per line. Long agent responses are automatically split across multiple messages with flood protection delays between them.

​
Setup

1

Choose your IRC server

Pick the IRC server you want your bot to join. Popular options:
  • Libera.Chat — irc.libera.chat (port 6697 with TLS)
  • OFTC — irc.oftc.net (port 6697 with TLS)
  • Your own server — use whatever hostname and port it runs on
If you want the bot to use a registered nickname, register it first with NickServ on the server:
2

Configure Comis

Add the IRC channel to your Comis configuration file (~/.comis/config.yaml):
If you registered a nickname, set the password in your ~/.comis/.env file:
Never store API keys, tokens, or passwords directly in config.yaml. Use the .env file or Secret Manager for credential management.
3

Restart and verify

Restart the Comis daemon to pick up the new configuration:
Check the logs for a successful connection:
Look for “IRC adapter started” or “channel-irc activated”.Join the configured channel on your IRC client and send a message mentioning the bot’s nick (e.g., comis-bot hello!) to confirm it responds.

​
Configuration

These options go under channels.irc in your config.yaml:

​
What your agent can do

Once connected to IRC, your agent can:
  • Send and receive messages in channels and direct messages (PRIVMSG)
  • Respond when mentioned by nick (for example, comis-bot what time is it?)
  • Format with IRC control codes (bold, italic, color, strikethrough)
  • Join, leave (part), and set channel topics via platform actions
IRC does not support reactions, editing or deleting sent messages, fetching message history, file attachments, threads, typing indicators, buttons, cards or embeds, streaming (live-updating responses), or native polls.

​
Platform limits

​
Troubleshooting

What happened: The IRC client cannot reach the server at the configured host and port.How to fix it: Check the host and port in your config. If using TLS (the default), make sure the port is the TLS port (usually 6697) and tls: true is set. For plaintext connections, use port 6667 and set tls: false. Also verify that your firewall allows outgoing connections on the configured port.
What happened: Another user or bot is already using the nickname you configured.How to fix it: Choose a different nick in your config, or register the nickname with NickServ on the server first and then set the nickservPassword so the bot can reclaim it. Some servers support the REGAIN command: /msg NickServ REGAIN yournick yourpassword.
What happened: The bot is connected to the server and present in the channel, but ignores messages.How to fix it: IRC bots typically respond to messages that mention their nick or to direct (private) messages. Try addressing the bot by name: comis-bot hello. Also check the allowFrom setting — if it contains specific nicks, only those users can trigger the bot.

Delivery Infrastructure

How streaming, typing indicators, and retry logic work under the hood.

Multiple users & teams

Run one install for a whole team - private per person, isolated per agent.

All Channels

Compare all 10 supported platforms side by side.

Agent Configuration

Set up your agent’s personality, tools, and behavior.

Secret Management

Learn how to manage API keys and tokens securely.