MessageLab — анализ переписки Telegram

MessageLab — бесплатная программа для детального анализа вашей переписки в Telegram.

Считает сообщения, стикеры, частые слова, активность по часам, время ответа и многое другое. Работает локально на вашем компьютере — данные никуда не отправляются.

---

Быстрый старт (без кода)

Windows

1. Скачайте архив из Releases или клонируйте репозиторий
2. Установите Python 3.10+ — при установке отметьте Add Python to PATH
3. Дважды кликните SETUP.bat — установка и настройка API ключей
4. Дважды кликните START.bat — откроется меню
5. Выберите «Анализировать чат», укажите @username или имя контакта
6. Отчёты сохраняются в папку reports/

macOS / Linux

git clone https://github.com/skintar/MessageLab.git
cd MessageLab
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # заполните ключи
python wizard.py

---

Где взять API ключи?

1. Откройте https://my.telegram.org/apps
2. Войдите по номеру телефона
3. Создайте приложение (название любое)
4. Скопируйте api_id и api_hash в настройки MessageLab

Это не пароль от аккаунта — только ключи для доступа к API Telegram.

---

Что умеет MessageLab

Категория	Метрики
Сообщения	Всего / ваших / собеседника, %, пустые, служебные
Стикеры	Количество, топ стикеров и стикер-паков
Слова	Топ частых слов с фильтром стоп-слов («и», «в», «the»…)
Медиа	Фото, видео, GIF, голосовые, документы
Активность	По часам, дням недели, месяцам, ночная/выходная
Поведение	Время ответа, reply, пересылки, редактирования, реакции
Экспорт	JSON и HTML отчёты

---

Скриншот меню

 ╭──────────────────────────────────────╮
 │           MessageLab v1.0.0            │
 │  Анализ переписки Telegram             │
 ╰──────────────────────────────────────╯

 Главное меню

   1 — Анализировать чат
   2 — Показать список чатов
   3 — Настройка (API ключи)
   4 — Инструкция
   0 — Выход

---

CLI (для продвинутых)

python main.py --wizard                    # интерактивное меню
python main.py --list-chats                # список чатов
python main.py --chat @username            # анализ
python main.py --chat @username --limit 5000
python main.py --chat @username --export report.json --export-html report.html

---

Структура проекта

MessageLab/
├── START.bat          ← запуск (Windows)
├── SETUP.bat          ← установка (Windows)
├── wizard.py          ← интерактивное меню
├── main.py            ← CLI
├── analyzer/          ← ядро аналитики
├── reports/           ← сохранённые отчёты
├── .env.example       ← шаблон настроек
└── requirements.txt

---

Безопасность

• Файлы .env и *.session хранятся только локально — не публикуйте их
• MessageLab не отправляет ваши сообщения на сторонние серверы
• Используйте только свой аккаунт Telegram
• Добавьте .env и *.session в .gitignore (уже добавлено)

---

Требования

• Python 3.10+
• Аккаунт Telegram
• API ключи с my.telegram.org
• Переписка должна быть в ваших диалогах

---

Частые вопросы

Программа просит код из Telegram
Это нормально при первом входе. Код приходит в приложение Telegram. После входа создаётся файл сессии — повторный код не нужен.

Не находит чат по ID
Используйте @username, имя контакта или ID из списка чатов (пункт 2 в меню).

Долго обрабатывает
Большие чаты (100k+ сообщений) занимают 5–15 минут. Можно ограничить: --limit 10000.

Ошибка Python not found
Установите Python с python.org и отметьте «Add to PATH».

---

Лицензия

MIT — см. LICENSE

---

Автор

skintar