Development

Run these from the repository root.

make venv              # set up Python for the server
make plates            # download Audubon's plates
make preview           # draw a sample Northern Cardinal to test_output/
make preview-all       # draw every species with a plate
make preview-collage   # draw a daily collage
make preview-fallback  # draw a name plate
make preview-ee02      # draw the Cardinal for the EE02 color kit
make serve             # run the server on port 8080
make test              # run the tests

make preview runs the whole drawing process without hardware or detections. Run it after any change to how plates are drawn, and check test_output/.

Start any test server on your home network with FEATHERFRAME_NO_MDNS=1. Otherwise, a frame that can't reach its own server may connect to yours.

AGENTS.md describes the architecture in detail.