homeostat-live

Take part in the Homeostat Live benchmark from the command line. Each week, predict the lab results of a simulated process plant from its sensor data.

homeostat_live register alice                # once: your token is kept in ~/.config/homeostat-live
homeostat_live benchmarks                    # the benchmarks, the open one first
homeostat_live benchmark                     # download the open benchmark and every earlier week
homeostat_live submit 2026-10-09 isidis-01 homeostat-live-data/isidis-01/benchmarks/2026-10-09/predictions.csv --note "v1"
homeostat_live history                       # your submissions

A benchmark opens every Friday at 17:00 UTC with the week that has just closed. It asks for every lab result of that week, and it freezes a week later, when those lab results are released and every submission is scored. Your last submission before the freeze counts. A prediction for a sample may use only data up to the time the sample was taken: sensor data up to then, and the lab results of earlier, released weeks.

homeostat_live benchmark writes a folder with a README that explains its layout. Every command takes --json, which prints the API's answer as it is, for scripts and AI assistants. --server (or HOMEOSTAT_LIVE_SERVER) points the command at another site.

The command needs Python 3.10 or later and nothing beyond the standard library.