Telegram Bot framework for Crystal

Header Image

Chat on Telegram

Telegram Bot API framework written in Crystal. Based heavily off of Telegraf this Crystal implementation allows your Telegram bot to be written in a language that's both beautiful and fast. Benchmarks coming soon.

If you want to extend your bot by using NLP, see my other library Cadmium.


Add this to your application's shard.yml:

    github: watzon/tourmaline
    version: ~> 0.10.0


For usage information please see the wiki. API documentation is also available here.


This currently supports the following features:

  • Bot API
    • Implementation examples
    • Easy command syntax
    • Robust middleware system
    • Standard API queries
    • Stickers
    • Inline mode
    • Long polling
    • Webhooks
    • Payments
    • Games
    • Telegram Passport

If you want a new feature feel free to submit an issue or open a pull request.


  1. Fork it ( )
  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


  • watzon Chris Watson - creator, maintainer
Github statistic:
  • 46
  • 5
  • 10
  • 1
  • 0
  • 3 days ago


MIT License