https://github.com/bnb32/modbot

This moderation bot software uses scikit-learn binary classification algorithms or pytorch neural networks to learn what phrases to allow in twitch chat. Labeled training data is constructed from chat logs with human moderation information. After training the software can be connected to twitch chat to automate moderation.
https://github.com/bnb32/modbot

irc-bot machine-learning moderation-bot pubsub twitch

Last synced: about 1 month ago
JSON representation

This moderation bot software uses scikit-learn binary classification algorithms or pytorch neural networks to learn what phrases to allow in twitch chat. Labeled training data is constructed from chat logs with human moderation information. After training the software can be connected to twitch chat to automate moderation.

• Host: GitHub
• URL: https://github.com/bnb32/modbot
• Owner: bnb32
• License: mit
• Created: 2022-06-18T15:12:59.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-20T00:49:08.000Z (about 2 years ago)
• Last Synced: 2024-10-14T03:07:03.849Z (3 months ago)
• Topics: irc-bot, machine-learning, moderation-bot, pubsub, twitch
• Language: Python
• Homepage: https://bnb32.github.io/modbot
• Size: 3.37 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
*********************

Welcome to Modbot!

*********************

This moderation bot software uses scikit-learn binary classification algorithms or pytorch neural networks to learn what phrases to allow in twitch chat. Labeled training data is constructed from chat logs with human moderation information. After training the software can be connected to twitch chat to automate moderation.

.. image:: https://github.com/bnb32/modbot/workflows/Documentation/badge.svg

    :target: https://bnb32.github.io/modbot/

.. image:: https://github.com/bnb32/modbot/workflows/Pytests/badge.svg

    :target: https://github.com/bnb32/modbot/actions?query=workflow%3A%22Pytests%22

.. image:: https://github.com/bnb32/modbot/workflows/Lint%20Code%20Base/badge.svg

    :target: https://github.com/bnb32/modbot/actions?query=workflow%3A%22Lint+Code+Base%22

.. image:: https://codecov.io/gh/bnb32/modbot/branch/main/graph/badge.svg

    :target: https://codecov.io/gh/bnb32/modbot

Installation

============

Follow instructions `here `_

Environment variables

=====================

Register bot with twitch and get Client ID and Client Secret `here `_.

Get `Oauth Token `_.

Update variables in ``config.json`` and ``__init__.py``.

.. code-block:: bash

    cd modbot/environment/

    cp config.json ../../my_config.json

    vim my_config.json

    vim __init__.py

    cd ../../

Training Model

==============

From scratch with classified messages in csv file

(with columns ``text``, ``is_offensive``):

.. code-block:: bash

    modbot-train -train -infile  -c my_config.json

Train from scratch from chatty data:

.. code-block:: bash

    modbot-train -infile  -train -clean -c my_config.json

Retrain with additional chatty data:

.. code-block:: bash

    modbot-train -append -infile  -train -clean -c my_config.json

Running

=======

Run bot:

.. code-block:: bash

    modbot -c my_config.json

.. inclusion-intro