This is the bot that is running in the Telegram channel of Laboratório Hacker de Campinas, a hackerspace located in Campinas, SP, Brazil.
We suggest the use of pyenv to manage your Python version and create an isolated environment where you can safely develop. After installing it, you can prepare the environment using the following commands:
$ pyenv virtualenv 3.11.5 myvenv
$ pyenv activate myvenv
$ python -m pip install -e .
Now you are ready to start development.
To run the bot, we need to provide some configuration info. These need to be defined as environment variables.
These variables are required to run the bot:
LHC_CHAT_ID- chat/channel ID. Follow this to know how to get this valueTELEGRAM_API_TOKEN- bot token. Use this tutorial to obtain a bot token. We suggest you to create a personal token to be used for your development tasks.
These variables are optional, but the lack of them will make some commands not to work:
FINANCE_STATUS_URL- API URL that returns a summary of financial status of hackerspaceICS_LOCATION- URL of hackerspace ICS calendar
After configuring the bot, you can run it using the following command:
$ python run.py
Bot is running in a fly.io account. If you are planning to upgrade the live bot in LHC channel, ask some member of LHC board to get access credentials.
Before start using fly.io, you need to authenticate with the right credentials. Use the command bellow and follow the instructions:
$ flyctl auth login
To set/update the environment variables to configure the bot (tokens, IDs, URLs, etc), use the following command for each variable you want to set:
flyctl secrets set VARIABLE_NAME="value"
You can see the list of secrets configured using the command:
flyctl secrets list
When everything is configured as desired, deploy to production using the command:
flyctl deploy --verbose
This command will show the status of the application:
flyctl status
This command will show the logs of the application:
flyctl logs