TelePi CLI
Telegram-мост к агенту Pi: продолжайте сессию с телефона голосом и скриншотами и возвращайте ее в терминал
- 146 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Telegram-чат получает управление кодирующим агентом на вашем компьютере: утечка токена бота или ваша ошибка в списке допущенных идентификаторов открывает чужим доступ к репозиториям.
- Облачная расшифровка отправляет голос в OpenAI (или на ваш адрес распознавания), а токен бота и ключи лежат в `~/.config/telepi/config.env`.
Установка
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/telepiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Telegram-чат получает управление кодирующим агентом на вашем компьютере: утечка токена бота или ваша ошибка в списке допущенных идентификаторов открывает чужим доступ к репозиториям.
- Облачная расшифровка отправляет голос в OpenAI (или на ваш адрес распознавания), а токен бота и ключи лежат в `~/.config/telepi/config.env`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TelePi — Telegram-бот, который работает на вашем компьютере и подключает чат к агенту Pi (проект pi-mono). Он открывает настоящие сессии Pi в ваших репозиториях. В терминале вы выполняете `/handoff`, в Telegram продолжаете сессию текстом, голосом или фото, а `/handback` возвращает ту же сессию в терминал и копирует команду возобновления в буфер обмена. Каждый чат или тема форума получает свою сессию, историю повторов и состояние выбора. Команды бота: `/sessions` показывает сессии всех проектов с переключением по кнопке, `/model` меняет модель, `/tree`, `/branch` и `/label` ходят по дереву сессии, `/retry` повторяет последнюю реплику, `/abort` прерывает операцию. Через `/commands` в Telegram доступны шаблоны промптов, скиллы и команды расширений Pi. Голосовые сообщения расшифровывает Parakeet CoreML на Apple Silicon, Sherpa-ONNX на Intel Mac и на CPU или облачный Whisper от OpenAI. Фото и картинки-документы уходят в Pi как изображения. Для задач по расписанию есть каталог входящих промптов: cron, фильтр почты или вебхук кладут в него файл `.txt`, и TelePi отправляет его содержимое в чат.
Для кого. Разработчикам, которые уже работают с Pi и хотят отвечать агенту с телефона: в дороге, вдали от рабочего места, голосом или скриншотом ошибки.
Подходит, если
- Агент ждет ответа, а вы ушли от компьютера: продолжить можно сообщением в Telegram.
- Ошибку проще показать скриншотом, чем описывать, и фото уходит в Pi как изображение.
- Диктовать удобнее, чем печатать на телефоне, а расшифровка должна идти локально.
- Сторонние события (cron, вебхук, фильтр почты) должны запускать промпты агента через каталог входящих.
- Несколько проектов ведутся в разных темах форума, и каждая тема должна держать свою сессию.
Не подходит, если
- Вы работаете не с агентом Pi: TelePi умеет только его.
- Нужен публичный бот для других людей: доступ ограничен списком ваших Telegram-идентификаторов.
- Рабочая машина выключена или спит: бот выполняется на ней, а не в облаке.
Пример запроса к агенту
Отправьте боту голосовое: «Запусти тесты в проекте и пришли, какие упали». Бот расшифрует его и передаст текст в сессию Pi.Ограничения
Нужны Node.js 22.19 или новее, токен бота от @BotFather, числовой Telegram ID для списка допущенных и настроенный Pi (файл `~/.pi/agent/auth.json`). Служба ставится как `launchd` на macOS и `systemd --user` на Linux; про службу Windows README не говорит. Локальная расшифровка требует `ffmpeg` и `parakeet-coreml` или `sherpa-onnx-node` с моделью в `SHERPA_ONNX_MODEL_DIR`, облачная требует `OPENAI_API_KEY` или собственный адрес распознавания. Это ранний релиз с открытым исходным кодом.
Как отключить. Остановите службу (`launchctl` на macOS, `systemctl --user disable --now telepi.service` на Linux), удалите пакет командой `npm uninstall -g @futurelab-studio/telepi` и расширение `~/.pi/agent/extensions/telepi-handoff.ts`; конфигурация лежит в `~/.config/telepi/config.env`.
Частые вопросы
Как установить TelePi?
Командой `npm install -g @futurelab-studio/telepi`, затем `telepi setup` задаст токен бота, список допущенных идентификаторов и рабочую папку, поставит службу и расширение `/handoff` для Pi. Состояние покажет `telepi status`.
Как передать сессию в Telegram и обратно?
В Pi выполните `/handoff`, откройте своего бота и пишите. Для возврата отправьте боту `/handback`: та же сессия возобновится в терминале командой, скопированной в буфер.
Кто может писать боту?
Только пользователи из `TELEGRAM_ALLOWED_USER_IDS`. Остальных бот отклоняет, даже если они нашли его имя. Инструменты Pi ограничены рабочей папкой активной сессии.
Работает ли расшифровка голоса без интернета?
Да, через локальные Parakeet CoreML (Apple Silicon) или Sherpa-ONNX (Intel Mac, CPU), если установлены `ffmpeg` и нужные пакеты. Облачный вариант использует Whisper от OpenAI.
Можно ли запускать TelePi в Docker?
Да. Для более строгой изоляции файловой системы есть образ без root с явно заданными точками монтирования на чтение и запись.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыMCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
Телеграм-бот для OpenCode: ставит задачи агенту, следит за ходом работы и переключает модели с телефона, пока OpenCode работает на вашем компьютере
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Telegram MCP от chaindead
Telegram MCP
MCP-сервер на Go для вашего Telegram: агент читает диалоги и непрочитанное, отмечает прочитанным, ответы кладет в черновики
Claude-to-IM
claude-to-im
Мост между Claude Code или Codex и мессенджерами: общайтесь с агентом из Telegram, Discord, Feishu, QQ или WeChat
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
Коротко о README
README открывается пятиминутным запуском и первой сессией, затем разбирает модель безопасности и полный список возможностей. Дальше идут настройка вручную, устранение типичных сбоев, таблица команд бота и разделы про каталог входящих промптов, голос и изображения.