Work
t
exd-tiktok-bot

A Telegram bot that downloads TikTok videos — and the project where the ExdBots system design was born.

Year2023 — present
RoleSolo
TypeTelegram bot
AccessOpen source
01 Overview

It looks simple — send a link, get a video. Under the hood it’s where I figured out how to structure a bot that could actually grow.

exd-tiktok-bot does one job well: you send it a TikTok link and it returns the video. But it was written before the agentic-engineering era, by hand, and it became my testing ground for system design — the menu system, the per-user state, the way flows are structured.

Those patterns worked well enough that I pulled them out into reusable libraries. The SDK idea and the internal packages that now power ExdBots all started here. It’s the template the platform grew from.

02 Highlights
UX Menu system
A structured, navigable menu — some of the best UX you'll find in a Telegram bot, and the seed of the ExdBots UI model.
Core Strong back-end
A solid back-end and system design I keep improving — robust enough to keep running and extend years later.
Origin Birthplace of the SDK
The internal libraries and the SDK concept behind ExdBots were first written and proven here.
Open Fully open source
The code is public — a real, readable example of how I structure a bot from scratch.
03 Architecture

A small, deliberate pipeline: the menu/state core is the part that later generalized into the SDK.

Input
Telegram updatemessage / link
Menu & state→ became the SDK
Work
Resolverparse TikTok URL
Downloaderfetch video
Output
Deliverysend to chat
// the menu/state core is what generalized into @exdbots
04 How it was built

This one was written the old way — no agents, no scaffolding, just figuring it out. That constraint is exactly why it matters to me: every structural decision was deliberate, because I had to make it myself.

The breakthrough was realizing the menu and state handling weren’t specific to TikTok at all — they were a general way to run any bot. Recognizing that, and extracting it cleanly, is what turned a single bot into the foundation for a platform.

Next project
ExdBots
© 2026 Tymur Mustafaiev
Built in TypeScript
GitHubTelegramXin