Aegisbot is a novel Discord bot with CEL-based auto-moderation - not just yet another "auto-mod" clone. It allows for fine-grained detection of malicious, spammy, or unwanted behavior using customizable matching rules written in a simple and common syntax such as YAML, rather than static keyword lists or simplistic triggers.

Huge thanks to @evilsocket for giving this bot idea.

🚧 Installation instructions will be added once the bot reaches a usable development milestone.

For now, feel free to watch the repository or join the Discord server to stay updated.

• Go ≥ 1.26.4
• A Discord bot token

git clone https://github.com/kkrypt0nn/aegisbot
cd aegisbot
make run

Coming soon!

Aegisbot will (hopefully) support:

• Pre-defined matches, like those weird and spammy characters
• Rule tags

• Scanning of messages, user profiles, rate of messages, etc.
• A GUI
  • To add, remove, deactivate and edit the rules
  • To run the bot super easily for local development

Currently a rule may look like

- rule:
    name: "CryptoScamPictures"
    meta:
      event: "message_create"
      ignoreBots: true
    actions:
      - type: "timeout"
        duration: "6h"
    expression: |
      message.getLinks().size() == 4 &&
      message.getLinks().all(l,
        (
          l.startsWith("https://cdn.discordapp.com/attachments/") ||
          l.startsWith("https://media.discordapp.net/attachments/")
        ) &&
        l.matches(".*\\.(png|jpg|jpeg|gif|webp)(\\?.*)?$")
      )

The documentation is available at https://aegisbot.krypton.ninja

The project is not meant to be used in production at the moment.

In the meantime, feel free to join the Discord Community to follow development updates or ask questions.

Contributions are more than welcome, but please wait until a v1 is released.

When it's time, please follow:

• Contributing Guidelines
• Code of Conduct

This bot was made with 💜 by Krypton and is under the AGPLv3 License.