Skip to content
Domekologe edited this page Jun 30, 2026 · 1 revision

Neko

🌐 English · Deutsch

Neko posts random neko/anime images and GIFs from nekos.best. It supports a fixed set of categories — four still-image categories and a large list of reaction GIFs — with autocomplete on the slash command, and works both as a prefix and a slash command. Author: pd-codes · requires Red 3.5.0+ · Status: Release.

Screenshot: Neko image embed in Discord

Installation

[p]repo add PDC_Redbot_Cogs https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC_Redbot_Cogs Neko
[p]load Neko
[p]slash sync

[p] is your bot's prefix. See Installation for the full Downloader walkthrough. Run [p]slash sync once so the /neko and /neko-cat slash commands appear.

Commands

Command Type Parameters What it does
neko Prefix category? Without an argument posts a random neko image. With a category, posts an image/GIF from that category. Invalid categories list the valid ones.
neko Slash Posts a random neko image (no category argument).
neko-cat Slash category Posts an image or GIF from the chosen category. The category field has autocomplete over all valid categories.

Each result is an embed with the image set, titled by the category and footed with the artist name and source URL returned by the API.

Categories

The autocomplete and validation use a fixed list — ALL_CATEGORIES = IMAGE_CATEGORIES + GIF_CATEGORIES:

Group Values
Images (4) husbando, kitsune, neko, waifu
GIFs (42) angry, baka, bite, blush, bored, cry, cuddle, dance, facepalm, feed, handhold, handshake, happy, highfive, hug, kick, kiss, laugh, lurk, nod, nom, nope, pat, peck, poke, pout, punch, run, shoot, shrug, slap, sleep, smile, smug, stare, think, thumbsup, tickle, wave, wink, yawn, yeet

Autocomplete filters by substring (case-insensitive) and returns up to 25 suggestions. The prefix neko command lowercases the input and rejects anything not in the list.

Notes

  • All content is fetched live from https://nekos.best/api/v2/<category>; if the API is unreachable the embed shows an error message.
  • This cog stores no data and has no configuration. It registers with the PDC Web Dashboard on load (no extra surfaces — it just attaches the drop-in hook), so it appears in the dashboard's cog list alongside the others.
  • For images filtered by rating (including NSFW), see NekoAPI.

See also: NekoAPI · Installation · Home

Clone this wiki locally