safari-bingo-cards/README.md

Safari Bingo Cards

Fun proof of concept to generate random wildlife bingo cards for safaris with data from Wikipedia.

Usage

Once the requirements are satisfied you can generate a card. By default it generates a 4x4 grid with 16 images:

$ ./generate.py -i data/animals.csv -o out.jpg

Requirements

Set up a Python 3.11+ virtual environment and install the requirements:

$ python3 -m .venv
$ source .venv/bin/activate
$ pip install -r requirements.lock

TODO

• Credit photographers — these photos are all some variation of CC-BY so we need to give attribution
• Add filtering by region — the metadata already exists, though perhaps needs to be adjusted
• Refactor — perhaps needs to be more object oriented
• Make a web frontend — I can imagine a light frontend that would shuffle the images in realtime and allow generation of a number of cards

License

This work is licensed under the GPLv3.

The license allows you to use and modify the work for personal and commercial purposes, but if you distribute the work you must provide users with a means to access the source code for the version you are distributing. Read more about the GPLv3 at TL;DR Legal.