Setup

1. Message @BotFather on Telegram to create a new Telegram bot. You will need the bot token later.

2. Sign up to get an OpenAI API key. It may be wise to set spending limits at this time.

3. Create a GCP account.

4. Create a GCP project. Enable the Cloud Functions API and Cloud Build API for your new project.

5. Message /start to @userinfobot on Telegram to get your Telegram user ID.

6. In the main directory, create a file terraform.tfvars with the following format:

project            = "your-project"
region             = "us-west1"
zone               = "us-west1-a"
user_email         = "your-google-email@example.com"

telegram_bot_token = "your:bot-token"
openai_api_key     = "your-api-key"

admin_id           = "your-telegram-user-id"
allow_public       = false

You may set allow_public to true if you would like anyone to be able to message the bot without approval.

7. Install Terraform and run terraform init and terraform apply. When the command finishes running, your bot should be ready to message!

8. If you would ever like to clean up the created resources, run terraform destroy.

Testing

Local testing

1. Run pip install -r requirements.txt && pip install pytest>=7.4.01.

2. Run $(terraform output -raw environment_variables). Additionally run export LOCAL_MODE=1 if you would like to run in polling mode.

3. If you would like to run the webhook test suite, run pytest -s test.py. If you would like to run locally with polling, run python main.py.

Cloud testing

1. Run python generate_test_terraform.py.

2. Run cp terraform.tfvars .test_env/terraform.tfvars.

3. Create a new bot with BotFather and replace the bot token in .test_env/terraform.tfvars with the test bot token.

4. Run terraform init and terraform apply.

5. This will create and run a separate copy of the bot.