Geen omschrijving

Fabian Peter Hammerle 4ed6bcb96f readme docker: restrict resources		3 jaren geleden
location_guessing_game_telegram_bot	558bb9bc90 configure python package; added readme	3 jaren geleden
.dockerignore	558bb9bc90 configure python package; added readme	3 jaren geleden
Dockerfile	558bb9bc90 configure python package; added readme	3 jaren geleden
Makefile	9e1153dd69 command-line options fallback to env vars; added dockerfile; rename script	3 jaren geleden
Pipfile	558bb9bc90 configure python package; added readme	3 jaren geleden
Pipfile.lock	558bb9bc90 configure python package; added readme	3 jaren geleden
README.md	4ed6bcb96f readme docker: restrict resources	3 jaren geleden
docker-compose.yml	bded47d485 setup docker-compose	3 jaren geleden
pyproject.toml	558bb9bc90 configure python package; added readme	3 jaren geleden
setup.py	558bb9bc90 configure python package; added readme	3 jaren geleden

Location Guessing Game Telegram Bot 🏞️ 🌍 📌

Basic Telegram Bot Sending Random Wikimedia Commons Photos

Setup

Download a dataset of photos via the WikiMap API, e.g. via:

wget --restrict-file-names=windows 'https://wikimap.toolforge.org/api.php?cat=Images_with_annotations&lang=de&year=2010-2015&region=49|9|46|18'

Generate a bot API token by sending /newbot to BotFather
Install bot via pip3 install --user --upgrade location-guessing-game-telegram-bot (or use docker / podman, see below)

Usage

Launch bot: location-guessing-game-telegram-bot --telegram-token-path file-containing-api-token --wikimap-export-path wikimap-export.json
Open a chat with the bot in Telegram by searching for the bot name previously sent to BotFather
Send /photo, wait, and repeat
Optionally add the bot to a group chat.

Docker / Podman 🐳

Pre-built docker images are available at https://hub.docker.com/r/fphammerle/location-guessing-game-telegram-bot/tags

$ sudo docker run --name location_guessing_game_telegram_bot \
    -v /file/containing/api-token:/telegram-token:ro -e TELEGRAM_TOKEN_PATH=/telegram-token \
    -v /wikimap/export.json:/wikimap-export.json:ro -e WIKIMAP_EXPORT_PATH=/wikimap-export.json \
    --read-only --cap-drop ALL --security-opt no-new-privileges \
    --cpus 0.4 --memory 128M \
    docker.io/fphammerle/location-guessing-game-telegram-bot:latest

Optionally, replace sudo docker with podman.

Annotation of signed tags docker/* contains docker image digests: https://github.com/fphammerle/location-guessing-game-telegram-bot/tags

Docker Compose 🐙

Clone this repository.
Edit paths in docker-compose.yml.
sudo docker-compose up --build

Trivia

Why create a Telegram bot instead of web app?

I created this mini game for my family including my grandparents who are comfortable using Telegram.

README.md