MiniGram is an ultraminimalistic Python library for building Telegram bots that's perfect for use in restricted environments like AWS Lambdas. Say goodbye to bloated libraries and hello to MiniGram's sleek and efficient design! ๐โจ
- Lightweight and minimalistic ๐
- Works in both synchronous and asynchronous modes โก๏ธ
- Seamless integration with popular web libraries like Starlette/FastAPI and aiohttp ๐
- Easy to use and understand API ๐
- Perfect for deploying bots in restricted environments like AWS Lambdas ๐
To start building your super cool Telegram bot with MiniGram, simply install it using pip:
pip install minigram-py
Using MiniGram is as easy as 1-2-3! Here are a few examples to get you started:
from minigram import MiniGram
class MyAwesomeBot(MiniGram):
def handle_update(self, update):
match update.update_type:
case "message":
match update.text:
case "/sync" | "/async":
self.reply(update, "I'm a bot, for sure! โ๏ธ")
case _:
self.send_text(
update.from_id,
f"I don't understand that command. ๐\nBut your id = {update.from_id}",
)
case "message_reaction":
self.reply(update, "I see you like this message!")
case "edited_message":
self.set_message_reaction(update, "๐")
bot = MyAwesomeBot(YOUR_BBOT_TOKEN)
bot.send_text(CHAT_ID, "Hello from an bot! ๐")
bot.start_polling()
In just a few lines of code, you've created a bot that responds to the "/start" command. How cool is that? ๐
from starlette.applications import Starlette
from starlette.routing import Route
from minigram import StarletteMiniGram
class MyStarletteBot(StarletteMiniGram):
async def incoming(self, msg):
if msg.text == "/hello":
return msg.reply("Hello from Starlette! ๐")
bot = MyStarletteBot("YOUR_BOT_TOKEN")
bot.set_webhook("https://yourwebsite.com/webhook")
app = Starlette(debug=True, routes=[
Route("/webhook", bot.starlette_handler, methods=["POST"]),
])
This example shows how seamlessly MiniGram integrates with Starlette, allowing you to create a webhook endpoint for your bot in no time! ๐
import asyncio
from minigram import AsyncMiniGram
class MyAsyncBot(AsyncMiniGram):
async def handle_update(self, update):
match update.update_type:
case "message":
match update.text:
case "/sync" | "/async":
await self.reply(update, "I'm a asynchronous bot, for sure! โ๏ธ")
case _:
await self.send_text(
update.from_id,
f"I don't understand that command. ๐\nBut your id = {update.from_id}",
)
case "message_reaction":
await self.reply(update, "I see you like this message!")
case "edited_message":
await self.set_message_reaction(update, "๐")
async def main():
bot = MyAsyncBot(BOT_TOKEN)
await bot.send_text(CHAT_ID, "Hello from an asynchronous bot! ๐")
await bot.start_polling()
if __name__ == "__main__":
asyncio.run(main())
MiniGram works just as well in asynchronous mode, making it easy to integrate with your existing async application. ๐๏ธ
We love contributions! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request on our GitHub repository. Let's make MiniGram even better together! ๐ช
MiniGram is released under the MIT License, so feel free to use it in your projects, whether they're open-source or commercial. ๐
Now go forth and build some amazing bots with MiniGram! ๐๐ค