A Telegram bot built with Grammy and Hono that allows users to search for MyGO!!!!! images by keywords. This bot is designed to be deployed on Cloudflare Workers, leveraging edge computing capabilities for fast responses.
- Search for MyGO!!!!! images by keywords
- View images directly in Telegram
- Interactive button interface for search results
- Optimized for edge deployment on Cloudflare Workers
- Uses Grammy framework for Telegram bot functionality
- Uses Hono framework for efficient request handling
MyGO!!!!! is a fictional band from the BanG Dream! franchise. The anime "BanG Dream! It's MyGO!!!!!" began airing on June 29, 2023, and focuses on the formation and journey of the band. The story follows Chihaya Anon, who transfers to Haneoka Girls' High School and wants to start a band to fit in. She recruits Takamatsu Tomori (nicknamed "Haneoka's Weirdo") and other members to form MyGO!!!!!
- Node.js (v18 or later)
- Cloudflare account
- Telegram Bot Token (from @BotFather)
- Cloudflare R2 or other image hosting service
- Clone this repository
- Install dependencies:
npm install- Set your environment variables in Cloudflare Workers:
wrangler secret put BOT_TOKEN
wrangler secret put IMAGE_HOSTOr for local development, create a .dev.vars file (this file should be added to .gitignore):
BOT_TOKEN="your_telegram_bot_token"
IMAGE_HOST="https://your-image-host.example.com"
To run the bot locally for development:
npm run devTo deploy the bot to Cloudflare Workers:
npm run deployAfter deployment, you need to set up a webhook for your Telegram bot. Replace YOUR_WORKER_URL with your actual Cloudflare Worker URL:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/setWebhook?url=YOUR_WORKER_URL/webhook
The following diagram illustrates the architecture of the MyGO!!!!! Bot:
graph TD
A[User] -->|Sends messages| B[Telegram]
B -->|Webhook| C[Cloudflare Workers]
subgraph CloudflareEnv[Cloudflare Workers Environment]
C -->|Processes requests| D[Hono App]
D -->|Routes| E[Webhook Endpoint]
D -->|Health check| F[Root Endpoint]
E -->|Handles Telegram events| G[Grammy Bot]
subgraph BotFunc[Bot Functionality]
G -->|Command handling| H[Start & Help Commands]
G -->|Message handling| I[Search Functionality]
G -->|Callback handling| J[Result Selection & Pagination]
end
I -->|Queries| K[(data.json)]
J -->|Retrieves| K
subgraph Storage[In-memory Storage]
L[userResults Map]
M[userPagination Map]
end
I -->|Stores results| L
J -->|Updates pagination| M
J -->|Retrieves results| L
end
G -->|Sends responses| B
J -->|Fetches images| N[Cloudflare R2 Storage]
classDef external fill:#f9f,stroke:#333,stroke-width:2px;
classDef storage fill:#bbf,stroke:#333,stroke-width:2px;
classDef component fill:#bfb,stroke:#333,stroke-width:2px;
class A,B,N external;
class K,L,M storage;
class D,E,F,G,H,I,J component;
style CloudflareEnv fill:#f5f5f5,stroke:#333,stroke-width:1px
style BotFunc fill:#e6f7ff,stroke:#333,stroke-width:1px
style Storage fill:#fff7e6,stroke:#333,stroke-width:1px
Once the bot is deployed and the webhook is set up, users can interact with it on Telegram:
/start- Get a welcome message/help- Get help on how to use the bot- Send any keyword to search for matching MyGO!!!!! images
- Click on search results to view the full image
The bot uses data from the MyGO!!!!! anime series, with images hosted on a Cloudflare R2 storage bucket or similar service.
MIT