Add remote TimesFM service integration

2026-03-29 22:13:10 +08:00
parent 5b0506a663
commit cdfc785402
12 changed files with 648 additions and 3 deletions
@@ -0,0 +1,32 @@
+# PolyWeather TimesFM Service
+
+This service isolates official `timesfm` inference from the main PolyWeather backend.
+
+## What it does
+
+- runs on Python 3.11+
+- installs official upstream `google-research/timesfm`
+- accepts recent `actual_high` or other temperature series payloads
+- returns point forecasts for the next 1 to 3 days
+
+## Local run
+
+```bash
+cd timesfm_service
+python -m venv .venv
+. .venv/bin/activate
+pip install -r requirements.txt
+git clone https://github.com/google-research/timesfm.git ../.timesfm-src
+pip install ../.timesfm-src
+uvicorn app:app --host 0.0.0.0 --port 8011
+```
+
+## Docker
+
+Build and run through the repo `docker-compose.yml`, or directly:
+
+```bash
+docker compose --profile timesfm up --build polyweather_timesfm
+docker build -f timesfm_service/Dockerfile -t polyweather-timesfm .
+docker run --rm -p 8011:8011 polyweather-timesfm
+```