polymath/KaikOut
1
0
Fork 0
forked from sch/KaikOut
Code Pull requests Activity
A moderation bot for the XMPP communication network.
2 commits 1 branch 0 tags 204 KiB
Python 100%
Find a file
Schimon Jehudah, Adv. 61c49c678a Add bots her.st and sid; 
Do not import kaikout.sqlite;
Improve handling of configuration session;
Add support for RTBL;
Add scores for actions kick (role none) and ban (affiliation outcast);
Add recourse functions to be utilized when bot affiliation is not owner;
Add functions to check for affiliations admin and owner.
2024-07-30 07:56:00 +03:00
kaikout Add bots her.st and sid; 2024-07-30 07:56:00 +03:00
LICENSE [WIP] This is the first commit, due to a demand of Kris. We will continue after Sunday in order to be coordinated with our Christian brothers. 2024-06-30 00:16:03 +03:00
pyproject.toml [WIP] This is the first commit, due to a demand of Kris. We will continue after Sunday in order to be coordinated with our Christian brothers. 2024-06-30 00:16:03 +03:00
README.md [WIP] This is the first commit, due to a demand of Kris. We will continue after Sunday in order to be coordinated with our Christian brothers. 2024-06-30 00:16:03 +03:00

README.md

Moderation bot for XMPP

KaikOut is a portmanteau of Kaiko and Out.

Kaiko (懐古) translates from Japanese to "Old-Fashioned".

Because spam has never been in fashion, unless it is served on a plate.

KaikOut

KaikOut is a moderation bot for the XMPP communication network.

KaikOut is an XMPP bot that suprvises group chat activity and assists in blocking and preventing of abusive and unsolicited type of messages and activities.

KaikOut is designed primarily for the XMPP communication network (aka Jabber). Visit https://xmpp.org/software/ for more information.

You can run your own KaikOut instance as a client, from your own computer, server, and even from a Linux phone (i.e. Droidian, Kupfer, Mobian, NixOS, postmarketOS), as well as from Termux.

All you need is one of the above and an XMPP account to connect KaikOut with.

Good luck!

Slixmpp

KaikOut is a powered by slixmpp.

XMPP

XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.

Visit XMPP for more information about the XMPP protocol and check the list of XMPP clients.

KaikOut is primarily designed for XMPP (aka Jabber), yet it is built to be extended to other protocols.

Features

Control

  • Blocklist - Check messages for denied phrases and words (activated by default).
  • Frequency - Check the frequency of messages and status messages (activated by default).
  • Inactivity - Check for inactivity (deactivated by default).
  • Moderation Abuse - KaikOut moderates the moderators.

Report

  • Logger - Log messages to CSV files.
  • Moderation Reports - KaikOut immediately reports to moderators about moderation activities made by other moderators.
  • Self Reports - KaikOut immediately reports to moderators about its moderation activities.

Special

  • Remote Management - KaikOut can be managed in two fashions, publicly (groupchat) and privately (chat).
  • Simultaneous - KaikOut is designed to handle multiple contacts, including groupchats, Simultaneously.
  • Visual interface - Interactive interface for XMPP using Ad-Hoc Commands,

Preview

KaikOut as appears with Cheogram.

Chat: Session Ad-Hoc: Commands Ad-Hoc: Edit bookmark Ad-Hoc: Settings

Getting Started

Install

It is possible to install KaikOut using pip and pipx.

pip inside venv

$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install git+https://git.xmpp-it.net/sch/KaikOut

pipx

Install
$ pipx install git+https://git.xmpp-it.net/sch/KaikOut
Update
$ pipx uninstall kaikout
$ pipx install git+https://git.xmpp-it.net/sch/KaikOut

Start

Start by executing the command kaikout and enter Username and Password of an existing XMPP account.

$ kaikout

You can also start KaikOut as follows:

$ kaikout --jid ACCOUNT_JABBER_ID --password ACCOUNT_PASSWORD

It is advised to use a dedicated extra account for KaikOut.

Recommended Clients

KaikOut works with any XMPP chat client; if you want to make use of the visual interface which KaikOut has to offer (i.e. Ad-Hoc Commands), then you are advised to use Cheogram, Converse, Gajim, monocles chat, Movim, Poezio, Profanity, Psi or Psi+.

Support

Please join our support groupchat whether you want help, discuss new features or just greet us.

Authors

Schimon (Author).

License

AGPL3 license.

Copyright

Schimon Jehudah Zackary, 2024