Skip to content
MIT licensed · Python 3.13 · MTProto

Telegram messages sent as you, 
not as a bot

tguser is a CLI that speaks MTProto from your own account, 
so an AI agent can write to private chats, groups and channels like a person.

uv tool install git+https://github.com/yerza06/tguser-cli.git
tguser login                           # one interactive sign-in, done by a human
tguser chat add work -1001234567890    # save the chat under the name "work"
tguser send "Build finished" --to work

How it fits together

A human signs in once — tguser login is interactive and asks for a phone number, a code and possibly a 2FA password. After that the session persists in ~/.config/tguser/, and every later send runs unattended. The agent never handles your credentials; it only calls tguser send.

Everything stays on your machine: the session file, the alias database and the API credentials live in ~/.config/tguser/, with .env at mode 600. There is no server component.