Metadata-Version: 2.5
Name: homeostat-live
Version: 0.1.0
Summary: Take part in the Homeostat Live benchmark: download a week's plant data and submit predictions of its lab results.
Project-URL: Homepage, https://homeostat.kausalflow.com/live/
Author: Lei Ma
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# homeostat-live

Take part in the [Homeostat Live](https://homeostat.kausalflow.com/live/) benchmark from the command line. Each week, predict the lab results of a simulated process plant from its sensor data.

```bash
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.
