Telegant

Telegant is a feature-rich Telegram bot framework specifically built for Crystal. Built with beauty and scalability in mind, it offers a simple syntax for creating complicated bot interactions while retaining Crystal's efficiency benefits.

🧩 Features

✨ Elegant annotation-based API - Define handlers with Crystal annotations
🛡️ Middleware system - Add customized logic, such as rate limitation, logging, or access restriction
🔌 Attachable middleware - Add middleware to specified handlers
📊 Context - Easy access to the current update properties and API calls
🔑 State management - Integrated user state management for complicated interactions
📑 Dialog management - Create multi-step conversations with built-in state management

🔨 Installation

Add Telegant to your shard.yml:

telegant:
  github: telegant/telegant
  branch: release/v0.0.1

Then run:

shards install

💡 Example

require "telegant"

class MyBot < Telegant::Bot
  @[Hears("hi", "hello")]
  def on_greet(update, bot)
    bot.reply("Hey there!")
  end
end

bot = MyBot.new("YOUR_BOT_TOKEN")
bot.start()

📖 Documentation

https://crystaldoc.info/github/Telegant/Telegant/main/index.html

❤️ Contribute

To-do

🗺️ Roadmap