Skip to content
A simple library to write simple IRC bots.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

What is JustIRC

JustIRC is a single-file IRC library that allows you to write simple IRC bots without having to deal with large frameworks. It's designed to be simple rather than feature-rich. That doesn't mean it doesn't have the necessary feautures for an IRC bot though.

JustIRC is

  • Event-based.
  • Handles pings automatically so you don't have to
  • Written in pure Python. Uses sockets instead of heavy frameworks.
  • Has simple functions for most IRC functionality. You don't have to touch a line of socket code.


  • ParrotBot - A bot that replies to you with the same message, just like a parrot.
  • HelloBot - A bot that greets people who say "Hi" or "Hello".
  • WeatherBot - A bot that responds to "!weather Istanbul" with the current weather.
  • TitleBot - A bot that responds with the titles of URLs posted to the channel.

Documentation and Examples

The library is quite new so I haven't found the time to document it yet. I will try adding some examples soon.

You can’t perform that action at this time.