HalpyBOT 1.4.2

This is the repository for HalpyBOT, the Hull Seals IRC Chatbot Assistant.


This repository houses all of the files required to build and host your own version of the Hull Seals IRC Chat Assistant, known to us as HalpyBOT. The system is how we manage cases, recite prepared instructions for Clients and Seals, and monitor our IRC network – all in one convenient bot.

This bot is in ACTIVE DEVELOPMENT, with many core features not yet implemented.



  • Python 3.5+
  • Asyncio Python Library
  • Pydle Python Library
  • Pure-SASL Python Library
  • MySQL Python Library
  • NumPy Python Library
  • Requests Python Library
  • Pytest Python Library
  • Boto3 Python Library
  • Aiohttp Python Library


To install, download the latest release from our repository. Upload and extract the files to the directory or subdirectory you wish to install from, and create your own config.py to fit your server, following the example config file provided.


  • Upon installation, be sure to replace the information in config.py to match your own details.
  • Additionally, be sure to create a user account and SASL credentials for your IRC user.
  • One of the most common sources of issues is your TLS settings in the bot – check these!
  • If you are having issues, look through the closed bug reports.
  • If no issue is similar, open a new bug report. Be sure to be detailed.
  • The notification module will not load if no Amazon Web Services config data is provided. The bot will run just fine without these, but staff notification functions will not be available.


The best way to receive support is through the issues section of this repository. As every setup is different, support may be unable to help you, but in general we will try when we can. If for some reason you are unable to do so, emailing us at Code[at]hullseals[dot]space will also reach the same team.


In the short term, the main priorities are to add more functions for the fact module, build a better command handling framework, and a reverse API for the client webhook Later down the line, we hope to expand the functionality of HalpyBOT to be a fully functional IRC assistant for our Seals.

As always, bugfixes, speed, and stability updates are priorities as discovered, as well as general enhancements over time.


Interested in joining the Hull Seals Cyberseals? Read up on the Welcome Board.

Authors and Acknowledgements

The majority of this code was written by David Sangrey, Rik Overveld and Feliksas

Many thanks to all of our Contributors.


This project is governed under the license.

Project Status

The bot is running v1.3.1 in production, but still under active development.


View Github