Shinobu is a Discord bot which provides service since 2016 and serves over 20,000 servers. It was a Nadeko clone at first, but then it got re-written from scratch using Discord.py.
There's a lot of TODO's around the code, which I could not find time to implement myself. If you find one and would like to contribute, that'd be appreciated :)
- Invite Shinobu to your server: https://midorina.dev/shinobu
- Top.GG: https://top.gg/bot/212783784163016704
- Support server: https://discord.gg/5RXauct
- Autosharding (provided by discord.py)
- Clustering
- IPC (interprocess communication) for clusters to be able to communicate with each other
- 15 Modules, 130+ Commands
- Custom ORM to communicate with the database
- Makes use of the following APIs:
- Reddit API (3D NSFW Content)
- Danbooru API (2D NSFW Content)
- Gelbooru API (2D NSFW Content)
- Rule34 API (2D NSFW Content)
- Sankaku Complex API (2D NSFW Content)
- Nekos.Life API (2D NSFW Content)
- Some Random API (Lyrics, Random Pictures etc.)
- Exchange API (Currency Conversion)
- Spotify API (Processing Spotify Links)
- Blizzard API (Searching Hearthstone Cards)
- Patreon API (Supporter Features)
- Git
- Python 3.10
- Install the repo and change your directory to the script's location:
git clone https://github.com/Midorina/Shinobu
cd Shinobu- Install the required libraries:
python3 -m pip install -r requirements.txt-
Fill in the
config_example.jsonfile following this guide: https://github.com/Midorina/Shinobu/wiki/Config-File.
Do not forget to rename it to your bot's name afterwards (e.g.config_shinobu.json). -
Run our IPC server with the port you specified in the config file (example is for port
13337):
cd ipc
python3 ipc.py --port 13337- Finally, open a new terminal,
cdinto the code directory run the bot (example is for bot nameshinobu):
cd Shinobu
python3 run.py shinobuIf you needed additional steps during installation, please specify and I will add them.