https://github.com/kkrypt0nn/aegisbot
🛡️ Pattern-match your Discord and Twitch defense
https://github.com/kkrypt0nn/aegisbot
Last synced: 4 months ago
JSON representation
🛡️ Pattern-match your Discord and Twitch defense
- Host: GitHub
- URL: https://github.com/kkrypt0nn/aegisbot
- Owner: kkrypt0nn
- License: agpl-3.0
- Created: 2025-09-12T19:53:53.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-01-23T17:00:19.000Z (5 months ago)
- Last Synced: 2026-01-24T07:16:28.581Z (5 months ago)
- Language: Go
- Homepage: https://aegisbot.krypton.ninja
- Size: 96.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Aegisbot
[](https://github.com/kkrypt0nn/aegisbot/actions)
[](https://discord.gg/xj6y5ZaTMr)
[](https://github.com/kkrypt0nn/aegisbot/commits/main)
[](https://conventionalcommits.org/en/v1.0.0/)
> [!CAUTION]
> **This project is under active development and is not yet ready for production use.**
> I strongly advise **not** using it until a stable release is published.
> **Contributions (especially the creation of rules) and feedback are welcome and appreciated once the core is complete.**
### 🛡️ Pattern-match your Discord and Twitch defense
Aegisbot is a novel Discord and Twitch bot with **advanced pattern-matching auto-moderation**, built on concepts inspired by [YARA](https://virustotal.github.io/yara/) - 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 or JSON, rather than static keyword lists or simplistic triggers.
Huge thanks to [@evilsocket](https://github.com/evilsocket) for giving this bot idea.
## Getting Started
### Installation
> 🚧 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](https://discord.gg/xj6y5ZaTMr) to stay updated.
### Prerequisites
- Go ≥ 1.25.6
- A Discord bot token
### Run Locally
```bash
git clone https://github.com/kkrypt0nn/aegisbot
cd aegisbot
make run
```
## Features
Coming soon!
## TODOs
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
## Rule example
Currently a rule may look like
```yaml
- rule:
name: "CryptoScamPictures"
meta:
event: "message"
ignoreBots: true
action:
type: "alert"
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)(\\?.*)?$")
)
```
## Documentation
Coming soon! Once the base rule engine and at least the Discord integrations are complete, a documentation will be hosted in the `website/docs/` folder and on a documentation website.
## Troubleshooting
The project is not meant to be used in production at the moment.
In the meantime, feel free to join the [Discord Community](https://discord.gg/xj6y5ZaTMr) to follow development updates or ask questions.
## Contributing
Contributions are more than welcome, but please wait until a `v1` is released.
When it's time, please follow:
- [Contributing Guidelines](./CONTRIBUTING.md)
- [Code of Conduct](./CODE_OF_CONDUCT.md)
## License
This bot was made with 💜 by Krypton and is under the [AGPLv3 License](./LICENSE.md).