Перейти к содержимому
Документация

Документация

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.