[FEAT] frame: flag and generate the local birds the bundle is missing

2026-06-30 16:59:11 -07:00
parent f8b467e9a2
commit 268b682c9d
5 changed files with 233 additions and 16 deletions
@@ -66,3 +66,11 @@ Pick how the frame gets its birds:
 Each one enables SPI + I2C, installs the deps and a systemd timer, writes `~/.birdframe/config.toml`, and reboots once to bring SPI up. Full options live in [`config.example.toml`](config.example.toml).

 BirdWeather mode renders on the Pi from this repo's illustrations on GitHub, so there is no image set to copy over. ZIP codes with no station nearby fall back to the closest ones. If you are far from any BirdWeather station, add `--ebird-key <key>` (a free key from [ebird.org/api/keygen](https://ebird.org/api/keygen)) and the frame fills from eBird sightings instead.
+
+The bundled illustrations center on the western U.S. If birds near your ZIP aren't in the set you cloned, the installer flags them and the frame skips them until they exist. To generate them, run [`generate_illustrations.py`](generate_illustrations.py) on a laptop or workstation (it uses the same rembg cutout as the rest of the pipeline, which the Pi can't fit in memory), passing your ZIP and a paid Google Gemini key, then commit the new cutouts or copy them to the Pi:
+
+```bash
+python3 generate_illustrations.py --zip 10001 --gemini-key YOUR_GEMINI_KEY
+```
+
+It generates only the species you're missing; `--country` and `--sample` carry through for non-US postcodes or a wider region.