Skip to content

habemuscode/grammY

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

grammY

The Telegram Bot Framework.


Bot API npm All Contributors

grammY makes it easy to create Telegram bots. Both for beginners and at scale.

You want grammY because it is easy to use. It is very powerful and always up to date. It has the best documentation in town. It is extremely efficient and scales up effortlessly. It has a thriving ecosystem of plugins, a friendly community chat, seamless integrations with web frameworks and databases, and so much more.

Are you ready? πŸ€–πŸš€

Bots are written in TypeScript (or JavaScript) and run on Node.js.

Quickstart

If you are new to Telegram bots, read the official Introduction for Developers written by the Telegram team.

Visit @BotFather and create a new bot. You will obtain a bot token.

Create a new directory and run

npm install grammy

inside it. Then create a file bot.js with this content:

const { Bot } = require("grammy");

// Create a bot object
const bot = new Bot(""); // <-- place your bot token in this string

// Register listeners to handle messages
bot.on("message:text", (ctx) => ctx.reply("Echo: " + ctx.message.text));

// Start the bot (using long polling)
bot.start();

Now you can run the bot via

node bot.js

and it will echo all received text messages.

Congrats! You just wrote a Telegram bot :)

Going Further

grammY has an excellent documentation, and an API Reference. It even integrates with your code editor, e.g. VSCode. You can hover over any element of grammY to get a detailed description of what that thing does or means.

If you are still stuck, just join the Telegram chat and ask for help. People are nice there and we appreciate your question, no matter what it is :)

Here are some more resources to support you:

Resources

β€”main project website and documentation.

β€”reference of everything that grammY exports.

β€”repository full of example bots. Includes a setup to easily run any of them.

β€”Telegram chat where you can ask any question about grammY or bots in general. We are also open for feedback, ideas, and contributions!

The Russian commnity chat can be found here.

β€”Telegram channel where updates to grammY and the ecosystem are posted.

β€”documentation of the API that Telegram offers, and that grammY connects to under the hood.

Deno Support

All grammY packages published by @grammyjs run natively on Deno. We are compiling every codebase to still run on Node.

However, given that most bot developers are still using Node, all documentation is written Node-first. We may migrate it if Deno overtakes Node. If you are already on Deno today, we expect you to know what you're doing. You mainly have to adjust the imports to URL imports, and import from https://deno.land/x/grammy/mod.ts.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


KnorpelSenf

πŸ€” πŸ’» πŸ“– 🎨 πŸ’‘ πŸ’¬ ⚠️ πŸ”Œ πŸ“¦ πŸ‘€ πŸ§‘β€πŸ«

Tecardo1

πŸ”Œ πŸ““

Wojciech Pawlik

πŸ€” πŸ‘€ πŸš‡ πŸ“¦

Alessandro Bertozzi

πŸ“–

trgwii

πŸ’» πŸ‘€

KnightNiwrem

πŸ’» πŸ› πŸ”Œ πŸ“– πŸ’‘ πŸ‘€ πŸ§‘β€πŸ«

Muthu Kumar

πŸ‘€

EdJoPaTo

πŸ”Œ πŸ“– πŸ€” πŸ‘€ πŸ› πŸ’» πŸ’¬

Amir Zouerami

πŸ“– πŸ”Œ

Roj

πŸ“– πŸ‘€ πŸš‡ 🌍 πŸ’»

jokasimr

πŸ›

Ciki Momogi

πŸ“–

AndreoliBR

πŸ‘€

Kirill Loskutov

πŸ“– πŸ› πŸ€”

Andrew Lane

πŸ› πŸ‘€

code-withAshish

πŸ“–

Stephane Mensah

πŸ› πŸ”Œ

Asaku01

πŸ“–

ppsimn

πŸ›

Satont

πŸ”Œ

deptyped

πŸ’‘ πŸ“– βœ… πŸ’¬

Jacek Nowacki

πŸ“– πŸ’» πŸ› πŸ‘€ πŸ€”

Outvi V

πŸ’»

Ikko Ashimine

πŸ“–

Yevhen Denesiuk

πŸ‘€ πŸ› πŸ’»

prastian

πŸ› πŸ’»

Sayem Chowdhury

πŸ€”

kospra

πŸ€” πŸ’»

Chimit

πŸ“–

Calsi

πŸ“–

Jonas Zohren

πŸ› πŸ’»

linbuxiao

πŸ“– 🌍

JiquanWang99

πŸ“– 🌍

Borhan Hafez

πŸ”Œ

WingLim

πŸ“– 🌍

taotie111

πŸ“– 🌍

Merlin

πŸ“–

Darvesh

πŸ› πŸ’»

dcdunkan

πŸ› πŸ’»

Kid

πŸ“– 🌍

Slava Fomin II

πŸ› πŸ“–

Kiko Beats

πŸ“–

Vsevolod

πŸ’» πŸ€” πŸ‘€

Habemuscode

πŸ‘€

This project follows the all-contributors specification. Contributions of any kind welcome!

About

The Telegram Bot Framework.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.7%
  • Shell 0.3%