A lightweight, modular, and fast Discord bot designed to bring cute anime illustrations right into your server!
🐾 Use this link to invite original NyaoPic to your server! - Click
Slash Commands— Built using modern, fast Discord Slash Commands (/neko).Modular Architecture (Cogs)— Easy to scale, add new features, and manage commands.Safe & Asynchronous— Powered bydisnakeandaiohttpfor non-blocking API requests.Nekos.best Integration— Fetches random, high-quality images of neko, waifu, kitsune, and more.
disnake- 2.12.0 or abovepython-dotenv- 1.2.2 or aboveaiohttp- 3.14.1 or above
Other requirements can be found in requirements.txt
1. Clone the repository:
$ git clone https://github.com/PersikPrime/NyaoPic.git
$ cd NyaoPic
2. Create a virtual environment & install dependencies:
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
3. Configure Environment Variables in your .env file:
BOT_TOKEN=your_secret_discord_bot_token_here
4. Run the Bot:
$ python3 main.py
NyaoPic/
├── cogs/ # Modular command folders (Cogs)
│ ├── boykissersend.py # Boykisser-sending command integration
│ ├── femboysend.py # Femboy-sending command integration
│ ├── furrysend.py # Furry-sending command integration
│ ├── fursuitsend.py # Fursuit-sending command integration
│ ├── waifusend.py # Waifu-sending command integration
│ ├── kitsunesend.py # Kitsune-sending command integration
│ ├── helpsend.py # Help-sending command
│ └── nekosend.py # Neko-sending command integration
├── .env # Private bot tokens (git-ignored)
├── .env.example # Environment template for others
├── .gitignore # Tells git what to ignore
├── main.py # Main bot entry point & cog loader
└── requirements.txt # List of dependencies