Discord bot that provides an easy way to get anime images and gifs randomly! This project stemmed from me testing how quickly I can get a new Discord app up and running using my bot template. It was so fast (roughly just under a week) in fact that I added way more features out of scope of me initially only wanting to get waifus.
That being said, I had quite a bit of fun with this even if it just was a test run. There were a bunch of really cool anime projects out there when I was trying to look for APIs to retrieve the images. I couldn't settle for just one so I ended up using these 3 super cool and awesome APIs!
- OtakuGifs - High quality gifs in a huge collection to choose from. Pretty straighforward endpoints too
- NekosAPI - Diverse categories with so much metadata of images. Most advanced of the endpoints I've seen out of the 3, I see its v2 is trying to move to json-api specs so that's pretty neat.
- Waifu.im - Possibly the best waifu resource out there, just top tier waifu images all round and an easy-to-use interface. Great sus collections too if you're into that ๐คท
Nino uses Discord's Slash Commands /
:
image
- shows a random anime imagegif
- shows a random anime gifwaifu
- shows a random waifu imageabout
- information hub of Ninohelp
- list of commandsabout
- generates Nino's invite link
You would need the following before getting started:
- Have a Discord Application created from the Discord Dev Portal
- Node with a version of at least v16.13.0
- Yarn
- Clone this repository and then change directory into it
git clone [email protected]:vexuas/nino.git
cd nino
- Install dependencies
yarn install
- Add required environment variables
- This project needs the following core environment variables to properly work
ENV
BOT_TOKEN
BOT_ID
GUILD_IDS
- Create a
environment.ts
file undersrc/config
mkdir src/config && touch src/config/environment.ts
- Export the relevant variables above
-
export const ENV = 'dev'; export const BOT_TOKEN = 'Your Discord Bot Token'; export const BOT_ID = 'Your Discord Bot ID'; export const GUILD_IDS = 'The Discord Server ID you want the bot to register Slash Commands in'
-
- This project needs the following core environment variables to properly work
- Add database configuration
- This project uses a PostGreSQL database to store Discord Guild information.
- If you don't particularly care about any of that, delete
src/database.ts
and any instances ofUSE_DATABASES
- Else, create a
database.ts
file undersrc/config
and export adatabaseConfig
variable-
//Fill these up with your db credentials export const databaseConfig = { database: '', host: '', user: '', port: 1234, password: '', ssl: { rejectUnauthorized: false, }, };
-
- Start the App
yarn start
TODO: Add better instructions and usage examples after finishing up the readme of djs-typescript-template