Документация
tguser — CLI-инструмент для отправки сообщений в Telegram от имени пользователя
(протокол MTProto, не бот). Позволяет писать в личные чаты, группы и каналы как обычный
человек, а именованные идентификаторы чатов хранятся локально в SQLite (по аналогии с git remote).
Стек: Python 3.13 · uv · Kurigram (форк Pyrogram) · Typer + Rich · Pydantic-Settings · SQLAlchemy 2.0 (async) + SQLite.
Оглавление
| Раздел | Описание |
|---|---|
| 01. Установка | Требования, глобальная установка из GitHub через uv tool install |
| 02. Авторизация | Получение api_id/api_hash, вход, выход, текущий аккаунт |
| 03. Конфигурация | Переменные TGUSER_*, расположение файлов |
| 04. Управление чатами | Именованные alias чатов (chat add/list/…) |
| 05. Отправка сообщений | Текст, файлы, фото, видео, аудио, контакты и др. |
| 06. Интеграция с ИИ-агентами | Глобальный вызов tguser, коды выхода, готовый Agent Skill |
| 07. Решение проблем | Частые ошибки и их устранение |
| 08. Обнаружение чатов | Как узнать ID чата (dialogs, resolve) |
Быстрый старт
uv tool install git+https://github.com/yerza06/tguser-cli.git # установить глобально из GitHub
tguser login # вход в аккаунт
tguser chat add work -1001234567890 # сохранить чат под именем work
tguser send "Привет" --to work # отправить сообщениеПосле uv tool install команда tguser доступна из любой директории — без uv run.
Установка из клона репозитория и режим разработки (uv sync + uv run) —
в 01. Установка.
⚠️ Не удаляйте файлы
~/.config/tguser/tguser.sessionи~/.config/tguser/tguser.db— это авторизация в Telegram и база сохранённых чатов. Что это за файлы, зачем они нужны и что будет, если их удалить, — в 03. Конфигурация.
См. также краткий обзор в корневом README-ru.md.