h2ofm 0.42.0__tar.gz

h2ofm-0.42.0/LICENSE

@@ -0,0 +1,175 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.

h2ofm-0.42.0/MANIFEST.in

@@ -0,0 +1 @@
+exclude AGENTS.md

h2ofm-0.42.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: h2ofm
+Version: 0.42.0
+Summary: H2O.ai Foundation Models — standalone inference
+Author: H2O.ai
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://h2oai.com/
+Keywords: foundation models,time series,forecasting
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY.md
+Requires-Dist: numpy>=1.26
+Requires-Dist: pandas>=2.0
+Requires-Dist: torch<3,>=2.10
+Requires-Dist: safetensors>=0.6.2
+Requires-Dist: huggingface-hub>=0.34
+Dynamic: license-file
+
+# h2ofm — H2O.ai Foundation Models
+
+Standalone inference for TimeH2O time-series models. Python 3.12+; CPU
+and CUDA.
+
+```bash
+pip install h2ofm
+```
+
+## Quick Start
+
+```python
+import numpy as np
+from h2ofm import TimeH2O
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+forecast = model.forecast(np.sin(np.arange(200) / 10), horizon=24)
+
+forecast.point  # (24,), median forecast; also forecast.median
+forecast.quantiles  # (24, 9), default levels 0.1 through 0.9
+forecast.quantile(0.9)  # (24,)
+```
+
+Loading defaults to `device="auto"` (CUDA if available, otherwise CPU).
+Set `batch_size` at load time (default 256): it counts target and covariate
+rows, not series. Checkpoints without cross-variate attention drop covariate
+rows first, so there only targets count. Checkpoint settings are available
+through `model.config`.
+
+## Array Forecasts
+
+`forecast(context, horizon=...)` returns a `Forecast` with CPU NumPy arrays:
+
+| Input shape            | `point` shape        | `quantiles` shape            |
+| ---------------------- | ---------------------- | ------------------------------ |
+| `(history,)`         | `(horizon,)`         | `(horizon, levels)`          |
+| `(targets, history)` | `(targets, horizon)` | `(targets, horizon, levels)` |
+
+`forecast_many(contexts, horizon=...)` forecasts several independent series
+in one pass. It takes a list of series, with possibly different history
+lengths, and returns one `Forecast` per series in input order:
+
+```python
+import numpy as np
+from h2ofm import TimeH2O
+
+contexts = [np.sin(np.arange(n) / 10) for n in (200, 150, 300)]
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+forecasts = model.forecast_many(contexts, horizon=24)
+
+len(forecasts)  # 3
+forecasts[0].point  # (24,)
+forecasts[0].quantiles  # (24, 9)
+```
+
+For array inputs, the first axis is the batch: a 2D array batches univariate
+series; a 3D array batches multi-target series.
+
+`quantile_levels` selects output levels (default 0.1 through 0.9) and their
+order on the last axis. Point forecasts are always medians.
+NaN marks missing observations; all-missing targets use a zero-valued cold start.
+
+Covariate arguments:
+
+- `past_covariates`: values observed over the **history** only, shaped
+  `(history,)` or `(covariates, history)`. Ignored by checkpoints without
+  past-covariate support.
+- `future_covariates`: known values spanning **history + horizon**, shaped
+  `(history + horizon,)` or `(covariates, history + horizon)`.
+- For `forecast_many`, pass one covariate entry per series, using `None`
+  where absent.
+- A covariate row is numeric when its dtype is numeric and not boolean.
+  Rows of any other dtype (strings, objects, booleans, `pd.Categorical`) are
+  categorical and encoded exactly as the matching `forecast_df` column, with
+  `None`/NaN as a missing label. Pass mixed covariates as a list of rows, e.g.
+  `[prices, holiday_names]`.
+
+Checkpoints without cross-variate attention ignore covariates with a warning.
+
+## Dataframe Forecasts
+
+Generate 100 days of two series with different periods and forecast the
+next 24 days:
+
+```python
+import numpy as np
+import pandas as pd
+
+from h2ofm import TimeH2O
+
+history, horizon = 100, 24
+days = np.arange(history)
+dates = pd.date_range("2026-01-01", periods=len(days), freq="D")
+
+frames = []
+for item, period in [("weekly", 7), ("monthly", 30)]:
+    value = np.sin(2 * np.pi * days / period)
+    frames.append(pd.DataFrame({"item": item, "date": dates, "value": value}))
+context = pd.concat(frames, ignore_index=True)
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+predictions = model.forecast_df(
+    context,
+    horizon=horizon,
+    target="value",
+    id_column="item",
+    time_column="date",
+)
+print(predictions.head())
+```
+
+`target` is one column name or a list of target column names
+(default `"target"`). Without `id_column`, the frame is one series;
+without `time_column`, rows stay in input order.
+The time column may contain datetimes or integer values representing time
+steps. Integer times are never converted to dates; forecast rows continue them
+at the inferred step, or at an integer `freq`.
+
+`context` contains only history, including trailing missing measurements or
+all-missing series. An integer `horizon` generates that many future steps per
+item, and every covariate is past-only.
+
+To supply future covariates, pass a horizon frame as `horizon` instead. Target
+columns in it must be absent or entirely missing. Every covariate column in the
+horizon frame is future-known, even when all its horizon values are missing (a
+missing categorical value is itself informative, e.g. "no holiday"); leave
+past-only covariates out of it, and timeh2o-v1 ignores them. Partial
+missingness is allowed, including items with no known values for a covariate.
+
+For panels, both frames must contain the same IDs, and every item in the
+horizon frame must have the same number of rows. That count sets the horizon.
+Future timestamps must continue each history at its inferred frequency (or the
+explicit `freq`), even without future covariates. Without time columns, rows
+retain their per-item input order. Neither input frame is mutated.
+
+Output columns: the supplied ID and time columns (or `step`, 1 to `horizon`,
+when no time column is given), `target_name`, `predictions` (median), and
+one column per quantile, e.g. `"0.1"`. `freq` overrides inferred frequency:
+a pandas offset alias for datetimes, the integer step between time values for
+an integer time column.
+
+## Forecast Options
+
+All three forecast methods accept:
+
+| Option                     | Behavior                                                                                                                                                           |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `context_length`         | Shorten the checkpoint's context window.                                                                                                                           |
+| `autoregressive=None`    | Use the checkpoint's default. `True` decodes beyond `max_horizon` in blocks; `False` uses one pass.                                                           |
+| `quantile_levels`        | Distinct levels between 0 and 1; levels outside the trained 0.1–0.9 grid use Gaussian-tail extrapolation.                                                         |
+| `flip_equivariant=False` | Set to `True` to make a flipped history always produce a flipped forecast. No extra pass for natively equivariant checkpoints; otherwise roughly doubles inference time. |
+| `clip_nonnegative=False` | Set to `True` to clamp forecasts at zero for targets with nonnegative histories. Applied last.                                                                    |
+
+## Model Checkpoints
+
+| Name                        | Parameters | Multi-target | Past covariates | Future covariates | Flip equivariant |
+| --------------------------- | ---------- | ------------ | --------------- | ----------------- | ---------------- |
+| `h2oai/timeh2o-v1-tiny`     | 5.8M       | independent  | No              | No                | Yes              |
+
+Multi-target modes, both forecasting the targets of an item in parallel:
+
+- **independent**: each target is forecast from its own history, as if the
+  targets were separate independent series.
+- **multivariate**: the targets are forecast as one multivariate series.
+
+Past and future covariates are always validated, but a checkpoint only
+uses the kinds it supports. The others are ignored with a warning.
+
+Flip-equivariant checkpoints honor `flip_equivariant=True` without an extra
+forecast pass; see Forecast Options.
+
+## License
+
+Apache-2.0; see the `LICENSE` file in the distribution. Upstream attribution:
+`THIRD_PARTY.md`, shipped alongside it.
+Model weights are downloaded and licensed separately.

h2ofm-0.42.0/README.md

@@ -0,0 +1,177 @@
+# h2ofm — H2O.ai Foundation Models
+
+Standalone inference for TimeH2O time-series models. Python 3.12+; CPU
+and CUDA.
+
+```bash
+pip install h2ofm
+```
+
+## Quick Start
+
+```python
+import numpy as np
+from h2ofm import TimeH2O
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+forecast = model.forecast(np.sin(np.arange(200) / 10), horizon=24)
+
+forecast.point  # (24,), median forecast; also forecast.median
+forecast.quantiles  # (24, 9), default levels 0.1 through 0.9
+forecast.quantile(0.9)  # (24,)
+```
+
+Loading defaults to `device="auto"` (CUDA if available, otherwise CPU).
+Set `batch_size` at load time (default 256): it counts target and covariate
+rows, not series. Checkpoints without cross-variate attention drop covariate
+rows first, so there only targets count. Checkpoint settings are available
+through `model.config`.
+
+## Array Forecasts
+
+`forecast(context, horizon=...)` returns a `Forecast` with CPU NumPy arrays:
+
+| Input shape            | `point` shape        | `quantiles` shape            |
+| ---------------------- | ---------------------- | ------------------------------ |
+| `(history,)`         | `(horizon,)`         | `(horizon, levels)`          |
+| `(targets, history)` | `(targets, horizon)` | `(targets, horizon, levels)` |
+
+`forecast_many(contexts, horizon=...)` forecasts several independent series
+in one pass. It takes a list of series, with possibly different history
+lengths, and returns one `Forecast` per series in input order:
+
+```python
+import numpy as np
+from h2ofm import TimeH2O
+
+contexts = [np.sin(np.arange(n) / 10) for n in (200, 150, 300)]
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+forecasts = model.forecast_many(contexts, horizon=24)
+
+len(forecasts)  # 3
+forecasts[0].point  # (24,)
+forecasts[0].quantiles  # (24, 9)
+```
+
+For array inputs, the first axis is the batch: a 2D array batches univariate
+series; a 3D array batches multi-target series.
+
+`quantile_levels` selects output levels (default 0.1 through 0.9) and their
+order on the last axis. Point forecasts are always medians.
+NaN marks missing observations; all-missing targets use a zero-valued cold start.
+
+Covariate arguments:
+
+- `past_covariates`: values observed over the **history** only, shaped
+  `(history,)` or `(covariates, history)`. Ignored by checkpoints without
+  past-covariate support.
+- `future_covariates`: known values spanning **history + horizon**, shaped
+  `(history + horizon,)` or `(covariates, history + horizon)`.
+- For `forecast_many`, pass one covariate entry per series, using `None`
+  where absent.
+- A covariate row is numeric when its dtype is numeric and not boolean.
+  Rows of any other dtype (strings, objects, booleans, `pd.Categorical`) are
+  categorical and encoded exactly as the matching `forecast_df` column, with
+  `None`/NaN as a missing label. Pass mixed covariates as a list of rows, e.g.
+  `[prices, holiday_names]`.
+
+Checkpoints without cross-variate attention ignore covariates with a warning.
+
+## Dataframe Forecasts
+
+Generate 100 days of two series with different periods and forecast the
+next 24 days:
+
+```python
+import numpy as np
+import pandas as pd
+
+from h2ofm import TimeH2O
+
+history, horizon = 100, 24
+days = np.arange(history)
+dates = pd.date_range("2026-01-01", periods=len(days), freq="D")
+
+frames = []
+for item, period in [("weekly", 7), ("monthly", 30)]:
+    value = np.sin(2 * np.pi * days / period)
+    frames.append(pd.DataFrame({"item": item, "date": dates, "value": value}))
+context = pd.concat(frames, ignore_index=True)
+
+model = TimeH2O.from_pretrained("h2oai/timeh2o-v1-tiny")
+predictions = model.forecast_df(
+    context,
+    horizon=horizon,
+    target="value",
+    id_column="item",
+    time_column="date",
+)
+print(predictions.head())
+```
+
+`target` is one column name or a list of target column names
+(default `"target"`). Without `id_column`, the frame is one series;
+without `time_column`, rows stay in input order.
+The time column may contain datetimes or integer values representing time
+steps. Integer times are never converted to dates; forecast rows continue them
+at the inferred step, or at an integer `freq`.
+
+`context` contains only history, including trailing missing measurements or
+all-missing series. An integer `horizon` generates that many future steps per
+item, and every covariate is past-only.
+
+To supply future covariates, pass a horizon frame as `horizon` instead. Target
+columns in it must be absent or entirely missing. Every covariate column in the
+horizon frame is future-known, even when all its horizon values are missing (a
+missing categorical value is itself informative, e.g. "no holiday"); leave
+past-only covariates out of it, and timeh2o-v1 ignores them. Partial
+missingness is allowed, including items with no known values for a covariate.
+
+For panels, both frames must contain the same IDs, and every item in the
+horizon frame must have the same number of rows. That count sets the horizon.
+Future timestamps must continue each history at its inferred frequency (or the
+explicit `freq`), even without future covariates. Without time columns, rows
+retain their per-item input order. Neither input frame is mutated.
+
+Output columns: the supplied ID and time columns (or `step`, 1 to `horizon`,
+when no time column is given), `target_name`, `predictions` (median), and
+one column per quantile, e.g. `"0.1"`. `freq` overrides inferred frequency:
+a pandas offset alias for datetimes, the integer step between time values for
+an integer time column.
+
+## Forecast Options
+
+All three forecast methods accept:
+
+| Option                     | Behavior                                                                                                                                                           |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `context_length`         | Shorten the checkpoint's context window.                                                                                                                           |
+| `autoregressive=None`    | Use the checkpoint's default. `True` decodes beyond `max_horizon` in blocks; `False` uses one pass.                                                           |
+| `quantile_levels`        | Distinct levels between 0 and 1; levels outside the trained 0.1–0.9 grid use Gaussian-tail extrapolation.                                                         |
+| `flip_equivariant=False` | Set to `True` to make a flipped history always produce a flipped forecast. No extra pass for natively equivariant checkpoints; otherwise roughly doubles inference time. |
+| `clip_nonnegative=False` | Set to `True` to clamp forecasts at zero for targets with nonnegative histories. Applied last.                                                                    |
+
+## Model Checkpoints
+
+| Name                        | Parameters | Multi-target | Past covariates | Future covariates | Flip equivariant |
+| --------------------------- | ---------- | ------------ | --------------- | ----------------- | ---------------- |
+| `h2oai/timeh2o-v1-tiny`     | 5.8M       | independent  | No              | No                | Yes              |
+
+Multi-target modes, both forecasting the targets of an item in parallel:
+
+- **independent**: each target is forecast from its own history, as if the
+  targets were separate independent series.
+- **multivariate**: the targets are forecast as one multivariate series.
+
+Past and future covariates are always validated, but a checkpoint only
+uses the kinds it supports. The others are ignored with a warning.
+
+Flip-equivariant checkpoints honor `flip_equivariant=True` without an extra
+forecast pass; see Forecast Options.
+
+## License
+
+Apache-2.0; see the `LICENSE` file in the distribution. Upstream attribution:
+`THIRD_PARTY.md`, shipped alongside it.
+Model weights are downloaded and licensed separately.

h2ofm-0.42.0/THIRD_PARTY.md

@@ -0,0 +1,33 @@
+## Third-party attribution — H2OFM
+
+The following parts of this package are adapted from
+[amazon-science/chronos-forecasting](https://github.com/amazon-science/chronos-forecasting) **v2.3.1** (`chronos-forecasting==2.3.1`), 
+licensed under **Apache-2.0**:
+
+- `src/h2ofm/timeh2o/_pipeline/df_utils.py`: dataframe validation,
+  normalization, frequency inference and future-frame construction, adapted
+  from `chronos/df_utils.py`.
+- `src/h2ofm/timeh2o/_pipeline/utils.py`: quantile interpolation and weighted
+  quantiles, adapted from `chronos/utils.py`.
+- `TimeH2O.forecast_df`: the dataframe interface, modeled on the Chronos-2
+  pipeline's `predict_df`.
+
+Both files are modified by H2O.ai and say so in their headers. The model
+itself is an independent implementation; methods it builds on are credited
+below. The license is in `LICENSE`. Upstream notice, reproduced as required by
+section 4(d) of the license:
+
+    Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+**Method references:**
+
+| Method                                                | Reference                                                                                                                                                              |
+| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Causal arcsinh scaling and residual patch projections | [Toto 2.0](https://arxiv.org/abs/2605.20119)                                                                                                                            |
+| CPM and parallel forecasting                          | [TiRex](https://arxiv.org/abs/2505.23719), [Toto 2.0](https://arxiv.org/abs/2605.20119)                                                                                  |
+| CPM iterative RevIN                                   | Google Research's TimesFM 3.0 team, [iterative refinement](https://github.com/google-research/timesfm/blob/master/src/timesfm3/torch/cpm_revin_refine.py) (2026)         |
+| Cross-variate attention                               | [Chronos-2](https://arxiv.org/abs/2510.15821)                                                                                                                           |
+| Future-covariate lookahead                            | [TimesFM 3.0](https://github.com/google-research/timesfm)                                                                                                               |
+| Layers and scaling                                    | [RoPE](https://arxiv.org/abs/2104.09864), [RMSNorm](https://arxiv.org/abs/1910.07467), [SwiGLU](https://arxiv.org/abs/2002.05202), [µP](https://arxiv.org/abs/2203.03466) |
+| RevIN                                                 | Taesung Kim et al., [RevIN](https://openreview.net/forum?id=cGDAkQo1C0p) (ICLR 2022)                                                                                     |
+| Test-time quantile averaging                          | [Vincentization](https://doi.org/10.1287/mnsc.1120.1667)                                                                                                                |

h2ofm-0.42.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "h2ofm"
+version = "0.42.0"
+description = "H2O.ai Foundation Models — standalone inference"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "Apache-2.0"
+license-files = ["LICENSE", "THIRD_PARTY.md"]
+authors = [{name = "H2O.ai"}]
+keywords = ["foundation models", "time series", "forecasting"]
+dependencies = [
+    "numpy>=1.26",
+    "pandas>=2.0",
+    "torch>=2.10,<3",
+    "safetensors>=0.6.2",
+    "huggingface-hub>=0.34",
+]
+
+[project.urls]
+Homepage = "https://h2oai.com/"
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { file = "src/**/*.py" }]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+h2ofm = ["py.typed"]

h2ofm-0.42.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

h2ofm-0.42.0/src/h2ofm/__init__.py

@@ -0,0 +1,10 @@
+# Copyright 2026 H2O.ai, Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+from importlib.metadata import version
+
+from . import timeh2o
+from .timeh2o import TimeH2O
+
+__version__ = version("h2ofm")
+__all__ = ["TimeH2O", "timeh2o", "__version__"]

h2ofm-0.42.0/src/h2ofm/timeh2o/__init__.py

@@ -0,0 +1,6 @@
+# Copyright 2026 H2O.ai, Inc.
+# SPDX-License-Identifier: Apache-2.0
+
+from ._api import Forecast, TimeH2O
+
+__all__ = ["Forecast", "TimeH2O"]