package

github.com/Scurrra/hamilton

0.5.0 / published Apr 30, 2026 / repository

Telegram Bot API wrapper for Crystal

hamilton

Crystal wrapper for Telegram Bot API (updated to 9.6) with optional async execution. Telegram Mini Apps are not supported.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      hamilton:
        github: Scurrra/hamilton
  2. Run shards install

Usage

require "hamilton"

API = Hamilton::Api.new(token: "<YOUR-API-TOKEN>")

handler = Hamilton::CmdHandler.new

@[Handler(handler)]
@[Handle(command: "/start")]
def handle_start_command(argument, context, update)
  # logic here
  return nil
end

@[Handler(handler)]
@[Handle(command: "help")]
def handle_help_command(argument, context, update)
  # logic here
  return nil
end

bot = Hamilton::Bot.new(
  api: API,
  handlers: [
    Hamilton::LogHandler.new, 
    handler
  ]
)

Signal::INT.trap do
  bot.stop
end

bot.listen

Usage guide with detailed explanation and example of the async bot can be found here.

Contributing

  1. Fork it (https://github.com/Scurrra/hamilton/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

API

  • For

    Annotation for the method in implementation of Hamilton::CmdHandler.

  • Hamilton

    Telegram Bot API wrapper for Crystal.

  • Handle

    Annotation for the method in implementation of Hamilton::CmdHandler.

  • Handler

    Annotation for the method in implementation of Hamilton::CmdHandler.