# Tgex

Tgex is a library for building Telegram bots in Elixir.

## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `tgex` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:tgex, "~> 0.0.1"}
  ]
end
```

Documentation can be generated with [ExDoc](https://github.com/elixir-lang/ex_doc)
and published on [HexDocs](https://hexdocs.pm). Once published, the docs can
be found at <https://hexdocs.pm/tgex>.

## Usage

## Motivation

Some of the Telegram bots are a great example of stateful applications. Each chat is a state, where user can interact with own instance of the bot.

Default way to build sequential stateful bots is [scenes](https://github.com/feathers-studio/telegraf-docs/blob/master/examples/scenes/scenes.ts) or [conversation](https://grammy.dev/plugins/conversations) patterns.

Tgex is a library that allows you to build sequential stateful bots in a more functional way. I did an [POC using Gleam](https://github.com/bondiano/telega-gleam) and it worked great. So I decided to implement it in Elixir.

Currently I don't have any plans to cover all the features of the Telegram API, but I'm open to suggestions and contributions.