Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time

License GitHub Workflow Status Docker Docker Image Size Discord

This Telegram Bot can tell the anime when you send an screenshot to it



  • Show anime titles in multiple languages
  • Telegram group support
  • Image, GIF, Video, URL support (stickers are not supported)
  • Video preview

How to use

  1. Start chatting with the bot
  2. Send anime screenshots (images, gif or video) directly to the bot
  3. You may also forward images from other chats to the bot
  4. The bot will tell you the anime, episode, and time code of it
  5. It will also send you a video preview of that scene

How to use (in group)

  1. Add the bot @WhatAnimeBot to your group
  2. Reply to any group image, mention the bot with @WhatAnimeBot
  3. Wait for the bot to reply

Note that the bot has no access to your messages before it is added to your group

How to host the bot on your own

If you have privacy concern, you can host the bot on your own.

Please read Telegram's official tutorial to create a Bot first.

You need to disable Privacy Mode if you want to use your bot in group chat.

Environment Variables

PORT=                 # (optional) Default: 3000
TRACE_MOE_KEY=        # (optional)
ANILIST_API_URL=      # (optional) Default:

Deploy to Heroku


Deploy on Railway

Deploy on Railway

Host with docker

Docker Image available on Docker Hub or GitHub Container Registry

docker run -it --rm --name trace-moe-tg-bot \
  -p 443:3000 \

Note that you need to configure a reverse proxy if you need HTTPS.

Host bare-metal with Node.js

Install Node.js 14.x, then:

git clone
npm install
  • Copy .env.example to .env
  • Edit .env as you need
node server.js

Host bare-metal with pm2

You also can use pm2 to run this in background in cluster mode.

Use below commands to start / restart / stop server.

npm run start
npm run stop
npm run reload
npm run restart
npm run delete

To change the number of nodejs instances, edit ecosystem.config.json