Cookbook: IRCClient

The Interface

The IRCClient module provides an inbox/outbox interface to IRC. Call SimpleIRCClientPrefab to obtain a connection to an IRC server.

Sending messages

Send tuples in the form *(cmd, [arg1] [,arg2] [,arg3...])* to SimpleIRCClientPrefab's "inbox". *cmd* should be an IRC command specified in RFC 1459 or RFC 2812. The first parameter specified by the RFCs should be *arg1*, the second should be *arg2*, and so on. Example messages to "inbox"::

  • ('NICK', 'Zorknpals')
  • ('USER', 'jlei', 'nohost', 'noserver', 'Kamaelia IRC Client')
  • ('JOIN', '#kamaelia')
  • ('PRIVMSG', '#kamtest', 'hey, how's it going?')
  • ('TOPIC', '#cheese', "Mozzerella vs. Parmesan")
  • ('QUIT')
  • ('QUIT', "Konversation terminated!")
  • ('BERSERKER', "Lvl. 10")

Note that "BERSERKER" is not a recognized IRC command. IRC_Client will not
complain about this, as it treats commands uniformly, but you might get
an error 421, "ERR_UNKNOWNCOMMAND" back from the server.

Sending CTCP commands

IRC_Client also handles a few CTCP commands:

("ME", channel-or-user, the-action-that-you-do).
If you use the outformat function defined here, 'MSG' commands are
treated as 'PRIVMSGs'.

No other CTCP commands are implemented.

A simple client that logs in

...and spams the channel #kamtest with 10 "Hello world" messages. (It's okay because no one else is ever on this channel)

class Spammer(component):
def main(self):
"""spams channel #kamtest"""
self.send(("NICK", "TheKamaeliaBot"))
self.send(("USER", "KamaeliaIRC", "stuff", "stuff", "Kamaelia IRC tester"))
self.send(("JOIN", "#kamtest"))
for _ in range(10):
self.send(("PRIVMSG", "#kamtest", "Hello world"))
yield 1

Pipeline(Spammer(), SimpleIRCClientPrefab()).run()

Now you will want to receive messages too, so your client isn't doomed to be a spammer. Lucky for you, SimpleIRCClientPrefab transmits IRC messages it receives in the form (cmd, sender, receiver, anything else). Simply link your component up to its "outbox" to receive these messages.


Logs in to a channel and writes all IRC traffic it hears to a text file.
from Kamaelia.File.Writing import SimpleFileWriter
from Kamaelia.Chassis.Graphline import Graphline
from Axon.Component import component
import IRCClient

class BasicLogger(component):

Outboxes = {"irc" : "to IRC, for user responses and login",
"outbox" : "What we're interested in, the traffic over the channel",
"signal" : "Shutdown handling in the future",

def __init__(self, channel, name, formatter=IRCClient.outformat):
super(BasicLogger, self).__init__() = channel
self.format = formatter = name

def login(self):
"""registers with the IRC server"""
self.send(("NICK",, "irc")
self.send(("USER",,,,, "irc")
self.send(("JOIN",, "irc")

def main(self):
"Main loop"
while True:
yield 1
while self.dataReady("inbox"):
data = self.recv("inbox")
formatted_data = self.format(data)
if formatted_data:
self.send(formatted_data, "outbox")

def respondToPings(self, msg):
if msg[0] == 'PING':
self.send(('PONG', msg[1]), 'irc')
self.send("Sent PONG to %s \n" % msg[1], "outbox")

#now define a prefab to wire everything up

def Logger(channel, name, server=''):
return Graphline(irc = IRCClient.SimpleIRCClientPrefab(server),
logger = BasicLogger(channel, name),
log = SimpleFileWriter("%s_log.txt" % channel.lstrip('#')),
linkages = {("logger", "irc") : ("irc", "inbox"),
("irc", "outbox") : ("logger", "inbox"),
("logger", "outbox") : ("log", "inbox"),


Logger('#test', 'coolLoggerDude').run() #we're assuming that no other user has this nickname! There's no error checking otherwise.

That's all there is! Have fun using the IRC components!


Kamaelia is an open source project originated from and guided by BBC Research. For more information browse the site or get in contact.

This is an ongoing community based development site. As a result the contents of this page is the opinions of the contributors of the pages involved not the organisations involved. Specificially, this page may contain personal views which are not the views of the BBC. (the site is powered by a wiki engine)

(C) Copyright 2008 Kamaelia Contributors, including the British Broadcasting Corporation, All Rights Reserved

This web site is powered by the same code created for the bicker manor project. For more details, contact Michael Sparks at BBC Research directly (cf contact)