Installation

GoyGram requires Python 3.11 or newer.

Install from PyPI

python -m pip install --upgrade goygram

Check what was installed:

python -c "from importlib.metadata import version; print(version('goygram'))"

The Python command and the command that starts your bot must use the same environment.

Install from source

Use a source install when your platform does not have a compatible wheel, for example on an ARM64 Termux device:

pkg update
pkg install python rust clang
python -m pip install --no-build-isolation .

The source build needs a Rust compiler and a C compiler.

Before you start

For a Bot API bot, create the bot with BotFather and keep its token private.

For an MTProto userbot, create an application at my.telegram.org and keep its api_id and api_hash private.

Do not commit tokens, API hashes, session files, auth keys, or vault files.

Next: Quick start: Bot API or Quick start: MTProto userbot.