---
title: livegram
emoji: 🌍
colorFrom: red
colorTo: blue
sdk: docker
pinned: false
---
# master-livegram

Advanced Telegram livegram system built with **Python + Telethon**.

## Features
- Master controller bot with:
  - CONNECT BOT
  - MY ALL BOTS
  - DISCONNECT
  - ADMIN PANEL
- Multi-assistant runtime with dynamic `.session` upload/start/stop
- HuggingFace Dataset-backed persistent storage with:
  - startup load/sync
  - manual sync button
  - periodic auto-sync
- Assistant features:
  - full message logging to group/owner DM
  - reply bridge (admin reply to forwarded message -> user)
  - `/menu` with Set Start Post, Set Message, Stats, Broadcast
  - broadcast progress (25/50/75/100), ETA, speed, summary

## Configuration
Copy `.env.example` to `.env` and fill values:
- `API_ID`
- `API_HASH`
- `HF_TOKEN`
- `HF_REPO_ID`
- optional: `HF_DATA_PATH`, `MASTER_SESSION_FILE`, `AUTO_SYNC_INTERVAL`

Super admin is enforced by spec as Telegram user ID `8413365423`.

## Run locally
```bash
pip install -r requirements.txt
python -m app.main
```

## Docker
```bash
docker build -t master-livegram .
docker run --env-file .env master-livegram
```