---

TeleWordle ES

The famous game of "Wordle" now on Telegram with Python.
Language: Spanish
Made with a 100% love.

Give the project a star!

Report Bug · Request Feature

About The Project

Inspired on the famous game "Wordle", I decided to make my own version of it on Telegram.

Main modules

• Flask
• requests
• Pillow

Bot installation

Setting up environment variables

In order to run the bot you have to set up the following environment variables:

• API_KEY - The API key provided by the bot father in Telegram

Linux

export API_KEY="YOUR_API_KEY"

Windows

cmd

set API_KEY="YOUR_API_KEY"

PowerShell

$env:API_KEY="YOUR_API_KEY"

Setting up the webhook

If we want to use our bot we need to set up a webhook, i.e., where we can receive the updates Telegram provides us. To achieve that we can use ngrok to get an HTTP/HTTPS URL or any host like heroku.

If we use heroku to host our Flask app it automatically will set up an URL for us, however, if we use ngrok instead to get an URL, we need to make sure that ngrok is running on the same host thar we are running our Flask app.

Once we have our URL and Flask app running, we need to make a request to setWebhook Telegram's endpoint.

Running the bot

You have 2 ways to run the bot:

• Using the flask module
• Using a WSGI Server (such as Gunicorn)

Using Flask module

To start the bot using the Flask module you need to set up the "FLASK_APP" environment variable:

Linux

export FLASK_APP="app:app"

Windows

cmd

set FLASK_APP="app:app"

PowerShell

$env:FLASK_APP="app:app"

Once you've set your environment variables you can run your bot with:

python -m flask run

or

flask run

Using a WSGI Server

There are multiple WSGI containers to choose from, here we will choose gunicorn as it is the easiest to set up.

First of all you need to install it via PIP

pip install gunicorn

Once we've done that we can start our Bot by doing

gunicorn app:app

And that's it, we should see our Bot being started :)

Usage of the bot

The bot is pretty much user-friendly, for now, we only have 2 commands (excluding the /help command):

• /newgame - Used to create a new game. In case that user already started a game, a message will be sent.
• /guess - Used to make a guess. If user doesn't provide a valid word a message will be sent.
• /giveup - Used to finish a game.

And that's it! you now know how to use the bot:).

Contributing

Wanna contribute to the project? Great! Please follow the next steps in order to submit any feature or bug-fix :) You can also send me your ideas to my Telegram, any submit is greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the AGPL-3.0 License. See LICENSE for more information.

Contact

Telegram: - @freshSauce

Project Link: https://github.com/freshSauce/TelegramWordle

Changelog

0.1.0

• Code uploaded to Github.