Skip to main content

An extensible chat bot that works across any number of chat programs

Project description

===============================
HavocBot
===============================

.. image:: https://img.shields.io/pypi/v/havocbot.svg
:target: https://pypi.python.org/pypi/havocbot

HavocBot is an extensible chat bot that works across any number of chat programs

Features
------

* Connect to multiple chat systems simultaneously
* Plugin system designed to work across all integrated chat clients
* New chat client integrations can be dropped into file system for new functionality
* More coming soon...

Installation
------

Install the latest version from pip

.. code:: bash

pip install havocbot

Copy the example `main.py`_ and `settings.ini`_ files into a new directory on your machine. Modify the settings.ini to include the neccessary API tokens and server settings for the chat clients that the bot should connect to.

Make sure the chat client is also listed in the 'clients_enabled' field in settings.ini

Open terminal and navigate to the directory where main.py and settings.ini is located.

.. code:: bash

python main.py

HavocBot should connect to the chat clients if valid credentials were provided


Credits
------
Mark Perdue (markaperdue_, https://www.righteousbanana.com)

.. _`main.py`: https://github.com/markperdue/havocbot/tree/master/src/havocbot/examples/main.py
.. _`settings.ini`: https://github.com/markperdue/havocbot/tree/master/src/havocbot/examples/settings.ini
.. _`markaperdue`: https://github.com/markperdue

Project details


Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page