Skip to main content

Download TikTok & Instagram content effortlessly

Production-grade Telegram bot with intelligent proxy rotation, 3-part retry strategy, and support for videos, slideshows, and audio — all without watermarks.

Get startedView API reference
TT-Bot logo

Get started in minutes

Deploy TT-Bot with Docker and start downloading content immediately

1

Clone the repository

Get the source code from GitHub:
git clone https://github.com/karilaa-dev/tt-bot.git
cd tt-bot
2

Configure environment

Copy the example environment file and add your Telegram bot token:
cp .env.example .env
Set at minimum:
BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
TELEGRAM_API_ID=1234567
TELEGRAM_API_HASH=abc123def456
TG_SERVER=http://telegram-bot-api:8081
DB_URL=postgresql://postgres:postgres@db/ttbot-db
3

Launch with Docker Compose

Start the bot along with the local Telegram Bot API server and PostgreSQL database:
docker compose up -d
The bot will automatically:
  • Initialize the database schema
  • Connect to Telegram
  • Start processing user requests
4

Send a TikTok or Instagram link

Open Telegram and send any TikTok or Instagram link to your bot. The bot will automatically detect the platform and download the content without watermarks.
The bot supports videos, slideshows, and audio extraction from both platforms.

Key features

Production-ready features for reliable content downloads at scale

Multi-platform support

Download videos, slideshows, and audio from TikTok and Instagram without watermarks

Smart retry strategy

3-part retry system with automatic proxy rotation for maximum reliability

Proxy rotation

Load-balanced proxy rotation to bypass rate limits and geographic restrictions

Multi-language

Support for 8 languages: English, Russian, Arabic, Hindi, Indonesian, Ukrainian, Somali, Vietnamese

Queue management

Per-user concurrency limits and intelligent queue processing

Admin controls

Broadcast messages, user management, and system statistics

Architecture highlights

Built on modern Python stack with production-grade patterns

System architecture

Modular design with separation of concerns: handlers, API clients, media processing, and database layers

Learn more

3-part retry strategy

Independent retry logic for URL resolution, metadata extraction, and download with automatic proxy rotation

Learn more

Media processing

Shared session pools, HEIF/AVIF conversion, thumbnail extraction, and optimized file handling

Learn more

Ready to deploy your bot?

Get your Telegram bot running in production with Docker Compose in under 5 minutes.

View quickstart guide