pi-durable-telegram0.1.5
Always-on durable pi agent on your server that you talk to in Telegram: a pi-durable Telegram gateway that survives crashes and restarts
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
EN · RU
pi-durable telegram
Твой собственный ИИ-агент, который живёт на твоём сервере и отвечает тебе в Telegram.
В основе pi, открытый агент для программирования, и его новый durable-движок pi-durable.
Установка
Нужны сервер на Linux, аккаунт Telegram и подписка на ИИ или ключ API. На сервере запусти:
curl -fsSL https://raw.githubusercontent.com/smixs/pi-durable-telegram/main/install.sh | bash
Скрипт задаст несколько вопросов, и бот ответит тебе в Telegram. Та же команда обновляет установку.
Пакет есть и в npm: npm install -g pi-durable-telegram, дальше настройка вручную по
docs/install.md.
Что делает скрипт, по шагам
Сначала скрипт рассказывает, что он сделает, и спрашивает разрешение. Дальше:
- Ставит pi, официальный, с pi.dev.
- Открывает pi, чтобы ты вошёл к своему провайдеру ИИ. Набери
/login, выбери провайдера, потом/quit. - Спрашивает токен бота. В Telegram открой @BotFather, отправь
/newbotи скопируй токен, который он выдаст. Потом напиши своему новому боту любое сообщение, так скрипт узнает, кто ты. - Запускает агента и ждёт, пока бот тебе ответит.
Уже пользуешься pi? pi install npm:pi-durable-telegram добавит скилл, который делает то же самое изнутри pi.
Подробнее в docs/install.md.
Что можно делать
- Спрашивать откуда угодно. «Посмотри, почему лежит сайт», «что съело диск». Агент работает на сервере и отвечает в чат.
- Присылать ему что угодно. Фото ошибки, PDF, голосовое. Он читает, смотрит, слушает и присылает файлы обратно.
- Уйти по делам. Закрой ноутбук и вернись через час: ответ уже ждёт, даже если сервер перезагружался.
- Читать без труда. В ответах бывают таблицы, списки дел и кнопки: нажми кнопку вместо того, чтобы печатать ответ. Пока агент печатает, под ответом есть кнопка «стоп».
Команды
| Отправь | И агент |
|---|---|
| что угодно: текст, фото, видео, файл, голосовое, геопозицию | возьмёт в работу и ответит |
/new |
начнёт новый разговор (старый сохранится) |
/stop |
остановит то, что делает сейчас |
/compact |
сожмёт длинный разговор до главного |
/status |
покажет модель ИИ, заполненность памяти и расход |
/help |
покажет этот список |
Подробнее
Как устроено
Твоё сообщение уходит в Telegram, агент на сервере забирает его, думает, пользуется инструментами и печатает ответ в чат у тебя на глазах. Сервер остаётся закрытым от интернета: агент сам ходит в Telegram, поэтому домен и веб-сервер тебе ни к чему.
Он помнит, где остановился. Каждый шаг агента сохраняется до того, как ты его увидишь. Если пропадёт питание, сервер перезагрузится или программа упадёт посреди ответа, агент запустится снова, найдёт закладку и закончит. Ответ придёт ровно один раз. Сообщения, которые ты пишешь, пока он занят, ждут своей очереди.
Плагины
Ядро остаётся маленьким: оно передаёт сообщения, файлы, кнопки и ответы. Новые умения приходят плагинами. Они лежат в
том же пакете и выключены, пока ты не включишь их одной строкой в настройках, например
PI_PLUGINS=search,skills,helpers,reminders. Плагин может быть и твоим собственным, из папки или из npm.
| Плагин | Что получает агент | Статус |
|---|---|---|
| Поиск в интернете | ищет в сети с твоим ключом Tavily, Exa, Brave или Parallel | готов |
| MCP | подключает MCP-серверы: календари, базы данных, твои инструменты | готов |
| Скиллы | папка с инструкциями, которые он читает, когда задаче это нужно | готов |
| Помощники | делит большую работу между агентами-помощниками, если хочешь, на модели подешевле | готов |
| Задачи и напоминания | сам делает что-то позже и первым пишет тебе | готов |
Как включить каждый и как написать свой: docs/plugins.md (на английском).
Безопасно ли это
- Говорить с ним можешь только ты. Бот отвечает тем аккаунтам Telegram, которые ты разрешил, и молча игнорирует остальных. Сообщения посторонних остаются непрочитанными: их никто не сохраняет и не передаёт ИИ.
- Он силён, и относиться к нему нужно так же. Агент может на сервере всё, что может твой пользователь. Добавляй только тех, кому доверил бы пароль, а на сервере с важными данными заведи агенту отдельного пользователя.
- Данные остаются у тебя. Разговоры и файлы лежат на твоём сервере. Провайдеру ИИ уходит только текст, который нужен модели.
Подробности в docs/security.md.
Вопросы
Нужно ли быть программистом? Достаточно иметь сервер и вставить в него одну команду. Дальше всё происходит в Telegram.
Сколько это стоит?
Сама программа бесплатная. Ты платишь за сервер и за ИИ, который подключишь: подписку, которая у тебя уже есть, или
ключ API. /status показывает, во что обошёлся разговор.
Какой ИИ можно подключить? Любой, с которым работает pi: Claude, ChatGPT, Gemini, OpenRouter, DeepSeek и многие другие. Ты выбираешь его при входе. Условия Anthropic могут ограничивать подписку Claude в сторонних программах, сначала прочитай их.
Может ли команда пользоваться одним ботом? Да. Добавь их id Telegram в настройки, и у каждого будет свой личный разговор. Все, кого ты добавил, получают одинаковую власть над сервером.
Работает ли в группах? Пока только в личных чатах.
Понимает ли голосовые? Да, если при установке указать ключ Deepgram.
Как удалить? Несколькими командами, они перечислены в docs/install.md.
Документы
Технические документы написаны на английском.
| Что читать | Когда нужно |
|---|---|
| docs/install.md | понять, что делает установщик, поставить вручную, обновить или удалить |
| docs/configuration.md | сменить модель, рабочую папку и другие настройки |
| docs/how-it-works.md | разобраться во внутреннем устройстве и в том, что именно переживает сбой |
| docs/security.md | узнать границы безопасности подробно |
| docs/library.md | собрать своё приложение поверх пакета или прислать код |
| CHANGELOG.md | посмотреть, что менялось от версии к версии |
Для ИИ-агентов
Если ты ИИ-агент и читаешь это для человека, вот где что лежит и чем этот проект отличается.
Куда смотреть
- В llms.txt главные факты в несколько строк.
- skills/pi-durable-telegram/SKILL.md описывает установку по шагам, которую можно пройти самому внутри pi: проверка машины, бот, модель, служба и настоящая проверка результата.
- install.sh делает ту же установку одним читаемым Bash-скриптом; docs/install.md объясняет каждый шаг и даёт команды обновления и удаления.
- В docs/configuration.md перечислены все настройки, а docs/how-it-works.md говорит, что происходит при каждом виде сбоя.
Что это такое, точно
Демон на pi-durable (@earendil-works/pi-durable),
который сам опрашивает Telegram Bot API. Один durable-разговор на каждый разрешённый личный чат, хранится в SQLite.
Инструменты: bash, read, write, edit и telegram_send_file. Использует вход pi и работает службой systemd
пользователя на Linux с Node.js 22.19 или новее.
Почему его выбирают вместо других вариантов
| pi-durable telegram | Telegram-мост в открытую сессию pi | pi в tmux по SSH | |
|---|---|---|---|
| Где работает агент | Службой на сервере, всегда включён | Внутри сессии pi, которую нужно держать открытой | В терминале, который ты держишь живым |
| Сбой или перезапуск посреди ответа | Ход продолжается, ответ приходит один раз | Ход обрывается | Ход обрывается |
| Сообщения, пока он занят | Надёжно встают в очередь и получают ответ по порядку | Зависит от сессии | Набираются руками |
| Доступ с телефона | Telegram | Telegram | SSH-клиент |
| Установка | Одна команда | Расширение внутри pi | Вручную |
Насколько нам известно, это первая Telegram-интеграция, построенная на самом pi-durable, поэтому durable здесь весь путь: ходы модели, вызовы инструментов и доставка ответа в чат. Проект маленький, под лицензией MIT, проверен тестами на повторные обновления, перезапуск посреди хода и недоступность Telegram.
Лицензия
MIT © smixs