Internet Relay Chat (IRC) protocol client library

The home of irclib is:

You can download project releases from PyPI.

Some legacy content is still available at the foundational SourceForge site.

Tests are continuously run using Travis-CI.

This library is intended to encapsulate the IRC protocol at a quite low level. It provides an event-driven IRC client framework. It has a fairly thorough support for the basic IRC protocol, CTCP and DCC connections.

In order to understand how to make an IRC client, I'm afraid you more or less must understand the IRC specifications. They are available here:



You have several options to install the IRC project.

The main features of the IRC client framework are:

Current limitations:

Unfortunately, this library isn't as well-documented as I would like it to be. I think the best way to get started is to read and understand the example program irccat, which is included in the distribution.

The following files might be of interest:

Example scripts in the scripts directory:

NOTE: If you're running one of the examples on a unix command line, you need to escape the # symbol in the channel. For example, use \#test or "#test" instead of #test.


Contributors: Jason R. Coombs <>, Jeff Huang <>, Joel Rosdahl <>