An open API service indexing awesome lists of open source software.

https://github.com/hypergonial/snedbot

Yet another kitchen sink bot, but this time it's yellow!
https://github.com/hypergonial/snedbot

discord discord-bot hikari python

Last synced: 3 months ago
JSON representation

Yet another kitchen sink bot, but this time it's yellow!

Awesome Lists containing this project

README

          

# Sned

> Sned is a general purpose Discord bot designed to make handling your community a breeze!

### [Add it to your server!](https://discord.com/oauth2/authorize?client_id=817730141722902548&permissions=1494984682710&scope=applications.commands%20bot)

### Main features:
- Powerful moderation commands
- Intuitive settings menu
- AutoMod
- Report system for users to anonymously report messages to your team
- Customizable logging to keep moderators accountable
- Toxicity filtering via [Perspective](https://www.perspectiveapi.com/)
- Rolebuttons for letting users pick their roles
- Starboard
- Tags system
- Reminders with snoozing and additional recipient support
- Fun commands such as tic-tac-toe and typeracer
- Much much more!

### Sned in action:

| Moderation tools | Settings & configuration | Rolebuttons | Reminders |
| ----------- | ----------- | ----------- | ----------- |
| ![Powerful moderation commands!](https://cdn.discordapp.com/attachments/836300326172229672/952785998138466364/unknown.png) | ![Intuitive Settings and Configuration](https://cdn.discordapp.com/attachments/836300326172229672/952786784666931300/unknown.png) | ![Rolebuttons in action](https://cdn.discordapp.com/attachments/836300326172229672/952789779471294464/unknown.png) | ![Reminder snoozing in action](https://cdn.discordapp.com/attachments/836300326172229672/952790270150320228/unknown.png) |

### Configuration:

To get started with setting up the bot on a server you have `Manage Server` permissions on, simply type `/settings`!

### Development:

If you'd like to contribute to Sned, or host it locally, you need the following utilities:

- [`make`](https://www.gnu.org/software/make/)
- [`docker`](https://www.docker.com/get-started/)
- [`python`](https://www.python.org/downloads/) - 3.10 or higher
- [`poetry`](https://python-poetry.org/docs/) - for managing python dependencies

To deploy the bot, create and fill out `.env`, you can see an example in `.env_example`, along with `config.py`, for which you can find an example in `config_example.py`.
Then simply run `make deploy` to start the bot in the background along with it's database.

If you'd like to contribute, please make sure to run [`nox`](https://nox.thea.codes/en/stable/index.html) in the project folder before submitting your changes. This should format all your code to match the project.