Telegram Clone

A tool to clone Telegram channels, tracking cloned messages, files and media and providing a web interface.

Installation

uv installation docs: https://docs.astral.sh/uv/getting-started/installation/

Using uv:

uv sync

Set up your .env file from .env.example with your Telegram API credentials and other settings.

Usage

By default, the application runs the web interface.

uv run src/telegram_clone/main.py

Access the web panel at http://localhost:5000 (or the configured WEB_PORT).

If you prefer the command-line interface, pass the --cli flag.

uv run src/telegram_clone/main.py --cli

Docker Usage

You can run the application using Docker on both Linux and Windows. Ensure you have Docker installed and running.

1. Build the image

Linux / macOS

docker build -t telegram-clone .

Windows (PowerShell)

docker build -t telegram-clone .

2. Run the container

You need to pass your .env file, publish the web port, and mount a volume for your Telegram session and database files to persist data.

Linux / macOS

docker run -it --rm \
  --env-file .env \
  -p 5000:5000 \
  -v $(pwd):/app \
  telegram-clone

Windows (PowerShell)

docker run -it --rm `
  --env-file .env `
  -p 5000:5000 `
  -v ${PWD}:/app `
  telegram-clone

To run the command-line interface via Docker, append the --cli flag to the run command.

docker run -it --rm \
  --env-file .env \
  -v $(pwd):/app \
  telegram-clone --cli