Автоответы с ИИ, архив удалённых сообщений, отложенные публикации и удобная переписка в браузере.
Вход как в сам Telegram: номер телефона и код, без ключей API и сложных настроек.
Возможности · Скриншоты · Быстрый старт · Безопасность · FAQ
TPAM (Telegram Personal Account Manager) подключается к личному аккаунту Telegram как ещё одно устройство, например Telegram Desktop, через официальный протокол MTProto. Это не бот: всё работает от вашего имени, но только по вашим правилам.
|
Ассистент понимает смысл сообщения и отвечает по вашей базе знаний (цены, график, частые вопросы). Он сам пропускает «спасибо», спам, разговоры о деньгах и личные темы. Работает на Claude от Anthropic, у каждого пользователя свой ключ. |
Каждое входящее сообщение сохраняется в момент получения. Если собеседник удалит или изменит его, у вас останется копия со всей историей правок. Удалённое видно прямо в чате. |
|
Диалоги, группы и каналы, ответы на сообщения, отправка файлов, поиск по тексту всех чатов. Работает на компьютере и на телефоне, есть светлая и тёмная тема. |
Публикация сразу или по расписанию: отложенный пост выходит силами самого Telegram, даже если TPAM выключен. Лента канала показывает просмотры и пересылки. |
|
Срабатывают по ключевым словам, на любое сообщение или по регулярному выражению. Работают только в выбранных чатах. Новое правило сначала работает в тестовом режиме: только записывает в журнал, что ответило бы, ничего не отправляя. |
Паузы между ответами, лимиты в час и в сутки, запрет отвечать ботам и защита от бесконечных переписок двух автоответчиков. Если Telegram заподозрит спам, автоматизация сама встанет на паузу. |
|
Прошлую переписку можно загрузить из официального экспорта Telegram Desktop. Дальше доступны мгновенный полнотекстовый поиск и выгрузка в CSV для Excel. |
Можно пользоваться одному на своём компьютере или запустить сайт для друзей и коллег. У каждого свои данные, а администратор управляет регистрацией. |
![]() Сообщения: диалоги, группы, каналы |
![]() Архив: удалённые и изменённые сообщения |
![]() Каналы: публикации со статистикой и по расписанию |
![]() Тёмная тема |
Ещё скриншоты: автоматизация, журнал, вход, телефон
| Автоматизация и ИИ | Журнал действий |
|---|---|
![]() |
![]() |
| Вход по номеру и коду | На телефоне |
|---|---|
![]() |
![]() |
Откройте сайт и нажмите «Посмотреть демо без входа». Откроются вымышленные чаты, на которых можно попробовать всё: автоответы, архив, публикации. Реальный Telegram при этом не используется.
# 1. Установите менеджер Python (uv) и Node.js, если их ещё нет
winget install --id astral-sh.uv -e
winget install --id OpenJS.NodeJS.LTS -e
# 2. Скачайте проект и запустите
git clone https://github.com/<ваш-аккаунт>/tpam.git
cd tpam
.\start.cmdПервый запуск сам установит всё нужное и откроет http://127.0.0.1:8765. Python 3.13 скачается автоматически.
- Один раз укажите API ID и API HASH приложения: сайт попросит их сам. Получить их можно на my.telegram.org → API development tools, подробная инструкция.
- Войдите по номеру телефона и коду из Telegram. Первый вошедший становится администратором.
macOS / Linux
git clone https://github.com/<ваш-аккаунт>/tpam.git && cd tpam
(cd frontend && npm ci && npm run build)
cd backend && uv run tpamcp .env.example .env # домен, API ID / HASH, ключ шифрования
docker compose up -d --buildCaddy автоматически получит HTTPS-сертификат. Подробности и чек-лист безопасности — в docs/DEPLOY.md.
Пользователи не вводят никаких ключей API: их один раз указывает владелец сервера. Вход устроен так же, как в официальном приложении Telegram:
sequenceDiagram
autonumber
actor U as Пользователь
participant W as Сайт TPAM
participant T as Telegram
U->>W: Номер телефона + согласие с условиями
W->>T: Запрос кода (ключи приложения на сервере)
T-->>U: Код в приложение Telegram
U->>W: Код (и облачный пароль, если включён)
W->>T: Вход
T-->>W: Сессия
W->>W: Шифрует сессию и создаёт личное пространство
W-->>U: Готово, открыт кабинет
После входа TPAM виден в Telegram → Настройки → Устройства как «TPAM (веб-клиент)». Там же его можно отключить в любой момент.
| 🔒 Шифрование | Сессии Telegram и ключи ИИ хранятся зашифрованными (Fernet). Номер телефона хранится только в виде хэша и маски. |
| 🙈 Ничего лишнего | Код подтверждения и облачный пароль сразу уходят в Telegram и нигде не сохраняются. В логах секреты маскируются. |
| 🧱 Изоляция | У каждого пользователя отдельная папка и база данных: правила, журнал, архив. |
| 🚦 Защита входа | Не больше 3 запросов кода в час на номер и 10 в час с одного IP, по 5 попыток ввода кода и пароля. Регистрацию можно закрыть. |
| 🌐 Веб-защита | HttpOnly-cookie, защита от CSRF, проверка Host и Origin, CSP; на сервере — только HTTPS и HSTS. |
| 🧯 Полный контроль | Можно выйти на всех устройствах, отключить Telegram или удалить все свои данные одной кнопкой. |
Чего TPAM намеренно не делает: массовые рассылки и приглашения, обход ограничений Telegram (FloodWait, CAPTCHA, 2FA), подделка официального клиента, сохранение исчезающих фото и видео, секретные чаты.
flowchart LR
B["🌐 Браузер<br/>React + TypeScript"] -- "cookie-сеанс · CSRF" --> A["⚡ FastAPI"]
A --> R["Runtime<br/>учётные записи · вход · гости"]
R --> U1["👤 Пространство пользователя"]
R --> U2["👤 Пространство пользователя"]
U1 --> TG["Telethon → Telegram MTProto"]
U1 --> DB[("SQLite<br/>правила · журнал · архив")]
U1 --> AI["Claude API<br/>ИИ-ответы"]
Технологии и структура проекта
| Слой | Технологии |
|---|---|
| Backend | Python 3.13, FastAPI, Telethon (MTProto), SQLAlchemy 2 + aiosqlite, SQLite FTS5, Anthropic SDK, cryptography |
| Frontend | React 19, TypeScript, Vite, Tailwind CSS 4, компоненты в стиле shadcn/ui на Radix, TanStack Query, Lucide |
| Качество | pytest, Vitest + Testing Library, mypy --strict, ruff, oxlint |
| Запуск | uv, Docker, Caddy (HTTPS) |
tpam/
├── backend/src/tpam/
│ ├── accounts/ # учётные записи, вход по номеру и коду, лимиты попыток
│ ├── ai/ # ИИ-ассистент (Claude)
│ ├── archive/ # архив сообщений, импорт экспорта Telegram
│ ├── automation/ # движок правил и ограничители
│ ├── providers/ # Telegram (Telethon) и демо-данные
│ ├── storage/ # SQLite: журнал, правила, архив с полнотекстовым поиском
│ ├── api/ # маршруты, защита, определение пользователя
│ └── runtime.py # пространства пользователей и гостей
├── frontend/src/
│ ├── pages/ # Обзор, Сообщения, Группы, Каналы, Архив, Автоматизация, Журнал…
│ ├── components/ # дизайн-система и компоненты чата
│ └── lib/ # API-клиент, запросы, тема, форматирование
├── docs/ # инструкции и скриншоты
├── Dockerfile · compose.yaml
└── start.cmd · dev.cmd
Все параметры необязательны и задаются переменными окружения с префиксом TPAM_ или в файле .env.
| Переменная | По умолчанию | Назначение |
|---|---|---|
TPAM_API_ID, TPAM_API_HASH |
— | Ключи приложения с my.telegram.org. Локально их можно ввести на сайте |
TPAM_SECRET_KEY |
создаётся сам | Ключ шифрования сессий. Сохраните его при переносе сервера |
TPAM_PUBLIC_URL |
— | Адрес сайта (https://…), обязателен для сервера |
TPAM_REGISTRATION_OPEN |
true |
Разрешить регистрацию новых пользователей |
TPAM_MAX_USERS |
200 |
Лимит пользователей |
TPAM_MAX_GUESTS |
50 |
Одновременных демо-гостей (0 — отключить демо) |
TPAM_PORT |
8765 |
Порт |
TPAM_DATA_DIR |
%LOCALAPPDATA%\tpam |
Папка данных |
.\dev.cmd # backend + Vite с горячей перезагрузкой → http://localhost:5173
cd backend # 106 тестов, строгая типизация
uv run pytest
uv run ruff check src tests
uv run mypy src
cd frontend # 30 тестов
npm test
npx tsc -b
npm run lintТесты не обращаются к сети: Telegram и Anthropic заменены имитациями.
Это безопасно? Меня не заблокируют?
TPAM использует официальный протокол Telegram и представляется честно, как «TPAM (веб-клиент)». Блокируют обычно за спам, поэтому в TPAM встроены жёсткие лимиты, а функций массовой рассылки нет. Не используйте сервис для рекламных рассылок и не включайте автоответы на новом аккаунте, у которого ещё нет истории.
Зачем нужны API ID и API HASH и почему их не вводят пользователи?
Это «паспорт» приложения в Telegram: свой есть даже у официального Telegram Desktop. Владелец TPAM получает его один раз на my.telegram.org, а пользователи входят только по номеру и коду.
Видит ли владелец сервера мои сообщения?
Технически у владельца сервера есть доступ к серверу, поэтому используйте только тот TPAM, которому доверяете, или запустите собственный. Архив по умолчанию выключен: если вы его не включите, переписка на сервере не хранится. Сессия хранится в зашифрованном виде, и её можно завершить в Telegram → Устройства.
Сколько стоят ИИ-ответы?
Платите вы сами, по тарифам Anthropic, своим ключом. Ассистент вызывается только после проверки всех ограничений, поэтому пропущенные сообщения ничего не стоят. Начните с тестового режима: ответы будут видны в журнале, но не уйдут собеседникам.
Почему архив не сохранил сообщение, удалённое ночью?
Копия создаётся в момент получения, поэтому TPAM должен быть запущен. На своём компьютере включите «Запускать вместе с Windows» в настройках архива, а на сервере TPAM работает постоянно.
Можно ли сохранять секретные чаты или исчезающие фото?
Нет. Секретные чаты привязаны к конкретному устройству и недоступны другим программам. Исчезающие медиа TPAM не сохраняет намеренно, из уважения к отправителю.
- Просмотр и скачивание медиа прямо в чате
- Редактирование и удаление своих сообщений
- Повторяющиеся публикации (каждый день или неделю)
- Инструменты администратора групп: модерация, закреп, приглашения
- Вход по QR-коду
TPAM — независимый проект, он не связан с Telegram FZ-LLC и не одобрен ею. Используя TPAM, вы обязуетесь соблюдать условия использования Telegram API и законы вашей страны о персональных данных. Если вы запускаете сервис для других людей, вы отвечаете за их данные.
Сделано с ❤️ для тех, кто ценит своё время







