Skip to main content

Serhii Telegram Bots Empire - Suite Architecture & Directory

Overview​

The Serhii Telegram Bots Empire is a distributed suite of automated Telegram microservices that I designed and built for backend developers, content creators, and daily digital workflows.

Rather than building a single, monolithic Telegram bot bloated with unrelated features, I architected this ecosystem around a Microservices Architecture pattern. Each bot operates as an independent, single-responsibility microservice that users can access directly or through my central portal bot (@serhiixxxbot). The gateway handles initial user onboarding, provides system navigation, and manages shared analytics across my bot fleet.

                    +-----------------------------+
                    |     [@serhiixxxbot] Hub     |
                    | (Central Gateway & Portal)  |
                    +--------------+--------------+
                                   |
       +---------------------------+---------------------------+
       |                           |                           |
       v                           v                           v
+---------------+          +---------------+          +---------------+
| Utility Bot   |          | Media / QR    |          | Image Engine  |
| @base64_...   |          | @response...  |          | @InstaResizer |
+---------------+          +---------------+          +---------------+

My Architectural Principles & EEAT Rationale​

Building production utility services inside Telegram presented specific engineering constraints, such as API rate limiting, transient polling drops, and payload size limits. I established three core architectural principles to guide the development of my Bots Empire:

  1. Micro-Ecosystem Decoupling: I isolated developer text utilities (e.g., cURL parsing, Base64 transformation) from CPU-heavy media processing (e.g., image resizing, barcode rendering). This ensures that processing large images never blocks real-time text parsing.
  2. Stateless Processing & Data Privacy: I designed all transformations to execute statelessly in memory. User-submitted text, cURL scripts, and image uploads are processed on the fly and immediately discarded after sending the response.
  3. Centralized Gateway & Health Monitoring: My main gateway bot (@serhiixxxbot) tracks high-level usage metrics (request volume, active users, microservice health) across all my bots without inspecting user data payloads.

My Technical Stack & Infrastructure Choices​

I built the entire bot fleet on a modern asynchronous Python backend tailored for high concurrency and operational reliability:

  • Core Frameworks: Python 3.12 utilizing AsyncIO with the python-telegram-bot (v20+) and aiogram 3 asynchronous libraries.
  • Image & Barcode Engines: Pillow (PIL) and OpenCV for dynamic image scaling, background blurring, and aspect ratio padding; python-barcode and qrcode for vector/raster rendering.
  • Async HTTP & Scraping: HTTPX for asynchronous API communication and yt-dlp for extracting YouTube video metadata, titles, and thumbnails.
  • Deployment & Hosting: Each bot runs inside a lightweight Docker container on my dedicated Linux VPS, supervised by Systemd and Docker Compose with automatic restart policies.

Ecosystem Bot Directory & Functional Capabilities​

Below is the complete directory of active bots that I have built and maintained within my ecosystem.

1. Central Portal & Gateway Bot (@serhiixxxbot)​

This is the main entry point to my bot network. I built it as an interactive gateway where users can explore available tools, check system metrics, or contact me directly.

Command Reference & Functions:​

  • /start - Welcomes users, displaying an interactive menu of all sub-bots along with live user count statistics.
  • /serhiixxx_bot - Inner hub command displaying my project directory, system health, and overall user metrics.
  • /contact - Shares my direct contact handle (@serhii_hrekov) and links to my open-source code repositories.

2. Developer Utility Bot (@base64_transform_bot)​

I built this bot as a developer Swiss-Army knife to streamline everyday backend engineering and DevOps tasks directly inside Telegram.

Command Reference & Functions:​

  • /start & /help - Initializes the session and provides a quick usage guide.
  • /encode_base64 - Converts raw text input into standard Base64 string formatting.
  • /decode_base64 - Decodes Base64 strings back to clean plaintext.
  • /replace_curly_quotes - Replaces smart/curly quotes (" " ' ') with standard ASCII straight quotes (").
  • /replace_single_quotes - Converts single-quoted strings (') into valid double-quoted JSON strings (").
  • /curl_converter - Converts raw cURL command lines into executable Python requests / httpx code blocks.
  • /json_formatter - Validates, indents, and pretty-prints raw JSON payloads.
  • /youtube_thumbnail - Downloads high-res YouTube video thumbnails (supports maxres, hq, mq, sd quality presets).
  • /youtube_title - Fetches the canonical title of a YouTube video without downloading video files.
  • /youtube_metadata - Extracts complete YouTube video metadata (uploader, tags, views) into a downloadable JSON file.
  • /coffee - Renders a developer coffee status animation and support link.

3. QR Code Generator Bot (@responseWithQrBot)​

An asynchronous image-generation bot I created to instantly convert text, URLs, or authentication strings into downloadable QR codes.

Command Reference & Functions:​

  • /start - Explains usage instructions and provides links to the open-source code.
  • Text & URL Input Handler - Converts any sent message or URL (up to 256 characters) into a high-density PNG QR code image.

4. Barcode Generator Bot (@responseWithBarcodeBot)​

I developed this utility to help developers and inventory testers quickly generate standard barcodes on the fly.

Command Reference & Functions:​

  • /start - Details supported numeric/alphanumeric barcode formats.
  • Numeric & String Input Handler - Converts alphanumeric strings (up to 64 characters) into high-resolution barcode images.

5. Instagram Image Resizer Bot (@InstaResizerBot)​

I built this image processing microservice to solve the common issue of fitting non-square photos into Instagram's 1:1 aspect ratio without cropping out key content.

Command Reference & Functions:​

  • /start - Presents interactive buttons to select background fill styles (transparent, black, white, blurred background).
  • Photo & Document Upload Handler - Processes uploaded photos (.jpg, .png, .heic, .webp), applying custom padding or Gaussian blur backgrounds while preserving image quality.

Related Documentation & Deep Dives​

To read detailed technical breakdowns of individual bots in my empire, visit their documentation pages:

Access the Empire​

Try any of my bots or explore the network directly through my central hub:

👉 Open Serhii's Bots Empire Hub (@serhiixxxbot)

Last updated on