diff --git a/docs/changelogs/index.md b/docs/changelogs/index.md
index 64a2abe4..121c2d51 100644
--- a/docs/changelogs/index.md
+++ b/docs/changelogs/index.md
@@ -2,6 +2,7 @@
Welcome to the TimeCopilot Changelog. Here, you will find a comprehensive list of all the changes, updates, and improvements made to the TimeCopilot project. This section is designed to keep you informed about the latest features, bug fixes, and enhancements as we continue to develop and refine the TimeCopilot experience. Stay tuned for regular updates and feel free to explore the details of each release below.
+- [v0.0.35](v0.0.35.md)
- [v0.0.34](v0.0.34.md)
- [v0.0.33](v0.0.33.md)
- [v0.0.32](v0.0.32.md)
diff --git a/docs/changelogs/v0.0.35.md b/docs/changelogs/v0.0.35.md
new file mode 100644
index 00000000..f080f1d9
--- /dev/null
+++ b/docs/changelogs/v0.0.35.md
@@ -0,0 +1,36 @@
+### Features
+
+* **PatchTST-FM family checkpoints**: Document and compare IBM Research and Granite PatchTST-FM releases via the existing `PatchTSTFM` class (`foundationforecast>=0.1.8`, `granite-tsfm>=0.3.8`). Pass `repo_id` to select the checkpoint:
+
+ - `ibm-research/patchtst-fm-r1` (default) — [CC-BY-NC-SA-4.0](https://huggingface.co/ibm-research/patchtst-fm-r1) (non-commercial research weights)
+ - `ibm-granite/granite-timeseries-patchtst-fm-r1` — [Apache-2.0](https://huggingface.co/ibm-granite/granite-timeseries-patchtst-fm-r1)
+ - `ibm-granite/granite-timeseries-patchtst-fm-r2` — [Apache-2.0](https://huggingface.co/ibm-granite/granite-timeseries-patchtst-fm-r2) / [OpenMDW 1.0](https://openmdw.ai/license/1-0/) (dual-licensed; commercial-friendly)
+
+ ```python
+ import pandas as pd
+ from timecopilot.models.foundation.patchtst_fm import PatchTSTFM
+
+ df = pd.read_csv(
+ "https://timecopilot.s3.amazonaws.com/public/data/air_passengers.csv",
+ parse_dates=["ds"],
+ )
+
+ model = PatchTSTFM(
+ repo_id="ibm-granite/granite-timeseries-patchtst-fm-r2",
+ alias="Granite-PatchTST-FM-r2",
+ context_length=2048,
+ )
+ fcst_df = model.forecast(df, h=12, freq="MS", level=[80, 90])
+ ```
+
+ **License note:** Only the IBM Research checkpoint (`ibm-research/patchtst-fm-r1`) is non-commercial ([CC-BY-NC-SA-4.0](https://huggingface.co/ibm-research/patchtst-fm-r1)). Granite PatchTST-FM r1 and r2 use permissive open licenses suitable for commercial use (see model cards above).
+
+* **PatchTST-FM family notebook**: Added [`patchtst-fm-family` example notebook](../examples/patchtst-fm-family.ipynb) comparing IBM Research `patchtst-fm-r1` with Granite `patchtst-fm-r1` and `patchtst-fm-r2`, including prediction intervals and evaluation metrics.
+
+### Dependencies
+
+* Bumped `foundationforecast` from `>=0.1.7` to `>=0.1.8` (Granite PatchTST-FM r2 via `granite-tsfm>=0.3.8`).
+
+---
+
+**Full Changelog**: https://github.com/TimeCopilot/timecopilot/compare/v0.0.34...v0.0.35
diff --git a/docs/examples/index.md b/docs/examples/index.md
index 75ff7bbb..6d649076 100644
--- a/docs/examples/index.md
+++ b/docs/examples/index.md
@@ -29,6 +29,7 @@ For model API details, see the [Model Hub](../model-hub.md).
| [Compare Foundation Models](ts-foundation-models-comparison-quickstart.ipynb) | Benchmark multiple foundation models side by side | Python 3.10+; GPU optional |
| [Chronos Family](chronos-family.ipynb) | Forecast with Chronos 1.x and 2.x checkpoints | Python 3.10+ |
| [TimesFM Family](timesfm-family.ipynb) | Forecast with TimesFM 1.0, 2.0, 2.5, and 3.0 with prediction intervals | Python 3.10+ |
+| [PatchTST-FM Family](patchtst-fm-family.ipynb) | Forecast with IBM Research PatchTST-FM r1 and Granite PatchTST-FM r1/r2 | Python 3.11–3.13; GPU recommended |
| [TabPFN Family](tabpfn-family.ipynb) | Forecast with TabPFN-2 and TabPFN-3 with prediction intervals | Python 3.10–3.12; `TABPFN_TOKEN` for LOCAL |
| [TiRex Family](tirex-family.ipynb) | Forecast with TiRex 1.0 and 2.0 | Python 3.11+ |
| [Toto Family](toto-family.ipynb) | Forecast with Toto 1.0 and 2.0 | Python 3.10+ |
diff --git a/docs/examples/patchtst-fm-family.ipynb b/docs/examples/patchtst-fm-family.ipynb
new file mode 100644
index 00000000..c34ea5fa
--- /dev/null
+++ b/docs/examples/patchtst-fm-family.ipynb
@@ -0,0 +1,697 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "id": "3e223474",
+ "metadata": {},
+ "source": [
+ "# Forecast Using the PatchTST-FM Family\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "7471dfd7",
+ "metadata": {},
+ "source": [
+ "TimeCopilot ships a single `PatchTSTFM` class for IBM PatchTST time series foundation models. Pass the Hugging Face `repo_id` to select the checkpoint:\n",
+ "\n",
+ "| Release | `repo_id` | License |\n",
+ "|---------|-----------|--------|\n",
+ "| **PatchTST-FM r1** (default) | `ibm-research/patchtst-fm-r1` | [CC-BY-NC-SA-4.0](https://huggingface.co/ibm-research/patchtst-fm-r1) (non-commercial) |\n",
+ "| **Granite PatchTST-FM r1** | `ibm-granite/granite-timeseries-patchtst-fm-r1` | [Apache-2.0](https://huggingface.co/ibm-granite/granite-timeseries-patchtst-fm-r1) |\n",
+ "| **Granite PatchTST-FM r2** | `ibm-granite/granite-timeseries-patchtst-fm-r2` | [Apache-2.0](https://huggingface.co/ibm-granite/granite-timeseries-patchtst-fm-r2) / [OpenMDW 1.0](https://openmdw.ai/license/1-0/) |\n",
+ "\n",
+ "*Requirements*:\n",
+ "\n",
+ " - Python 3.11 – 3.13\n",
+ " - CUDA recommended (CPU works but is slower)\n",
+ "\n",
+ "**License:** Only `ibm-research/patchtst-fm-r1` is non-commercial. Granite r1 and r2 use permissive licenses suitable for commercial use.\n",
+ "\n",
+ "PatchTST-FM supports flexible context lengths (default 8,192). We use `context_length=2048` here for a faster comparison. For probabilistic forecasts, pass `level` or `quantiles` (quantiles from 0.01 to 0.99).\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "e209fdc2",
+ "metadata": {},
+ "source": [
+ "## Import libraries\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "id": "d8df60df",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-09-23T20:20:53.772699Z",
+ "iopub.status.busy": "2026-09-23T20:20:53.772622Z",
+ "iopub.status.idle": "2026-09-23T20:21:02.487061Z",
+ "shell.execute_reply": "2026-09-23T20:21:02.486780Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "INFO:datasets:JAX version 0.7.1 available.\n",
+ "2026-09-23 14:04:14,687\tINFO util.py:155 -- Missing packages: ['ipywidgets']. Run `pip install -U ipywidgets`, then restart the notebook server for rich notebook output.\n",
+ "2026-09-23 14:04:15,038\tINFO util.py:155 -- Missing packages: ['ipywidgets']. Run `pip install -U ipywidgets`, then restart the notebook server for rich notebook output.\n"
+ ]
+ }
+ ],
+ "source": [
+ "import sys\n",
+ "\n",
+ "import pandas as pd\n",
+ "\n",
+ "from timecopilot import TimeCopilotForecaster\n",
+ "\n",
+ "if sys.version_info < (3, 11) or sys.version_info >= (3, 14):\n",
+ " raise RuntimeError(\"PatchTST-FM requires Python >= 3.11 and < 3.14\")\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "f25cbb5a",
+ "metadata": {},
+ "source": [
+ "## Load the dataset\n",
+ "\n",
+ "The DataFrame must include at least the following columns:\n",
+ "- unique_id: Unique identifier for each time series (string)\n",
+ "- ds: Date column (datetime format)\n",
+ "- y: Target variable for forecasting (float format)\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "id": "296a7e2a",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-09-23T20:21:02.488315Z",
+ "iopub.status.busy": "2026-09-23T20:21:02.488235Z",
+ "iopub.status.idle": "2026-09-23T20:21:02.858483Z",
+ "shell.execute_reply": "2026-09-23T20:21:02.858142Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "\n",
+ "\n",
+ "
\n",
+ " \n",
+ " \n",
+ " | \n",
+ " unique_id | \n",
+ " ds | \n",
+ " y | \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
+ " | 0 | \n",
+ " Oktoberfest | \n",
+ " 2020-01-31 | \n",
+ " 25376 | \n",
+ "
\n",
+ " \n",
+ " | 1 | \n",
+ " Oktoberfest | \n",
+ " 2020-02-29 | \n",
+ " 28470 | \n",
+ "
\n",
+ " \n",
+ " | 2 | \n",
+ " Oktoberfest | \n",
+ " 2020-03-31 | \n",
+ " 23816 | \n",
+ "
\n",
+ " \n",
+ " | 3 | \n",
+ " Oktoberfest | \n",
+ " 2020-04-30 | \n",
+ " 46186 | \n",
+ "
\n",
+ " \n",
+ " | 4 | \n",
+ " Oktoberfest | \n",
+ " 2020-05-31 | \n",
+ " 31213 | \n",
+ "
\n",
+ " \n",
+ "
\n",
+ "
"
+ ]
+ },
+ "execution_count": 3,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "TimeCopilotForecaster.plot(df)\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "232f095e",
+ "metadata": {},
+ "source": [
+ "## Create a TimeCopilotForecaster\n",
+ "\n",
+ "We compare IBM Research PatchTST-FM r1 with Granite PatchTST-FM r1 and r2. Each model gets a distinct `alias` so forecasts are easy to identify.\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 4,
+ "id": "b455275d",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-09-23T20:21:02.897878Z",
+ "iopub.status.busy": "2026-09-23T20:21:02.897799Z",
+ "iopub.status.idle": "2026-09-23T20:21:02.903296Z",
+ "shell.execute_reply": "2026-09-23T20:21:02.903116Z"
+ }
+ },
+ "outputs": [],
+ "source": [
+ "from timecopilot.models.foundation.patchtst_fm import PatchTSTFM\n",
+ "\n",
+ "context_length = 2048\n",
+ "batch_size = 32\n",
+ "\n",
+ "models = [\n",
+ " PatchTSTFM(\n",
+ " repo_id=\"ibm-research/patchtst-fm-r1\",\n",
+ " alias=\"PatchTST-FM-r1\",\n",
+ " context_length=context_length,\n",
+ " batch_size=batch_size,\n",
+ " ),\n",
+ " PatchTSTFM(\n",
+ " repo_id=\"ibm-granite/granite-timeseries-patchtst-fm-r1\",\n",
+ " alias=\"Granite-PatchTST-FM-r1\",\n",
+ " context_length=context_length,\n",
+ " batch_size=batch_size,\n",
+ " ),\n",
+ " PatchTSTFM(\n",
+ " repo_id=\"ibm-granite/granite-timeseries-patchtst-fm-r2\",\n",
+ " alias=\"Granite-PatchTST-FM-r2\",\n",
+ " context_length=context_length,\n",
+ " batch_size=batch_size,\n",
+ " ),\n",
+ "]\n",
+ "\n",
+ "tcf = TimeCopilotForecaster(models=models)\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8fb70efe",
+ "metadata": {},
+ "source": [
+ "## Cross-validate with prediction intervals\n",
+ "\n",
+ "Optional parameters:\n",
+ "- `freq`: pandas frequency alias (inferred from `ds` if omitted)\n",
+ "- `h`: forecast horizon\n",
+ "- `level`: prediction interval levels (percent)\n",
+ "\n",
+ "Pass `level` values that map to the model's 0.01-spaced quantiles (for example `80` → 0.1/0.9, `90` → 0.05/0.95).\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 5,
+ "id": "96b89954",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-09-23T20:21:02.904237Z",
+ "iopub.status.busy": "2026-09-23T20:21:02.904175Z",
+ "iopub.status.idle": "2026-09-23T20:21:36.929928Z",
+ "shell.execute_reply": "2026-09-23T20:21:36.929457Z"
+ }
+ },
+ "outputs": [
+ {
+ "name": "stderr",
+ "output_type": "stream",
+ "text": [
+ "0it [00:00, ?it/s]Warning: You are sending unauthenticated requests to the HF Hub. Please set a HF_TOKEN to enable higher rate limits and faster downloads.\n",
+ "WARNING:huggingface_hub.utils._http:Warning: You are sending unauthenticated requests to the HF Hub. Please set a HF_TOKEN to enable higher rate limits and faster downloads.\n",
+ "Loading weights: 100%|██████████| 253/253 [00:00<00:00, 8405.02it/s]\n",
+ "[transformers] `use_return_dict` is deprecated! Use `return_dict` instead!\n",
+ "100%|██████████| 1/1 [00:04<00:00, 4.87s/it]\n",
+ "1it [00:05, 5.45s/it]\n",
+ "Loading weights: 100%|██████████| 253/253 [00:00<00:00, 7321.87it/s]\n",
+ "100%|██████████| 1/1 [00:08<00:00, 8.09s/it]\n",
+ "1it [00:08, 8.53s/it]\n",
+ "0it [00:00, ?it/s]INFO:tsfm_public.models.patchtst_fm.modeling_patchtst_fm:Stacked blocks: (0):ConformerBlock-5 --> (1):ConformerBlock-5 --> (2):ConformerBlock-3 --> (3):ConformerBlock-3 --> (4):ConformerBlock-5 --> (5):ConformerBlock-5 --> (6):ConformerBlock-3 --> (7):ConformerBlock-3 --> (8):ConformerBlock-5 --> (9):ConformerBlock-5 --> (10):ConformerBlock-3 --> (11):ConformerBlock-3 --> (12):ConformerBlock-5 --> (13):ConformerBlock-5 --> (14):ConformerBlock-3 --> (15):ConformerBlock-3 --> (16):ConformerBlock-5 --> (17):ConformerBlock-5 --> (18):ConformerBlock-3 --> (19):ConformerBlock-3 --> (20):ConformerBlock-5 --> (21):ConformerBlock-5 --> (22):ConformerBlock-3 --> (23):ConformerBlock-3 --> (24):ConformerBlock-5 --> (25):ConformerBlock-5 --> (26):ConformerBlock-3 --> (27):ConformerBlock-3 --> (28):ConformerBlock-5 --> (29):ConformerBlock-5\n",
+ "Loading weights: 100%|██████████| 646/646 [00:00<00:00, 8177.81it/s]\n",
+ "100%|██████████| 1/1 [00:19<00:00, 19.51s/it]\n",
+ "1it [00:20, 20.12s/it]\n"
+ ]
+ },
+ {
+ "data": {
+ "text/html": [
+ "\n",
+ "\n",
+ "
\n",
+ " \n",
+ " \n",
+ " | \n",
+ " unique_id | \n",
+ " ds | \n",
+ " cutoff | \n",
+ " y | \n",
+ " PatchTST-FM-r1 | \n",
+ " PatchTST-FM-r1-lo-80 | \n",
+ " PatchTST-FM-r1-hi-80 | \n",
+ " PatchTST-FM-r1-lo-90 | \n",
+ " PatchTST-FM-r1-hi-90 | \n",
+ " Granite-PatchTST-FM-r1 | \n",
+ " Granite-PatchTST-FM-r1-lo-80 | \n",
+ " Granite-PatchTST-FM-r1-hi-80 | \n",
+ " Granite-PatchTST-FM-r1-lo-90 | \n",
+ " Granite-PatchTST-FM-r1-hi-90 | \n",
+ " Granite-PatchTST-FM-r2 | \n",
+ " Granite-PatchTST-FM-r2-lo-80 | \n",
+ " Granite-PatchTST-FM-r2-hi-80 | \n",
+ " Granite-PatchTST-FM-r2-lo-90 | \n",
+ " Granite-PatchTST-FM-r2-hi-90 | \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
+ " | 0 | \n",
+ " Black Friday | \n",
+ " 2024-09-30 | \n",
+ " 2024-08-31 | \n",
+ " 2607 | \n",
+ " 2097.164307 | \n",
+ " 1727.202881 | \n",
+ " 3229.980713 | \n",
+ " 1311.553955 | \n",
+ " 5043.822266 | \n",
+ " 2018.981689 | \n",
+ " 1770.181152 | \n",
+ " 3816.510986 | \n",
+ " 1501.957520 | \n",
+ " 6320.073242 | \n",
+ " 2367.684326 | \n",
+ " 1840.466553 | \n",
+ " 3370.302734 | \n",
+ " 1673.035645 | \n",
+ " 4834.735840 | \n",
+ "
\n",
+ " \n",
+ " | 1 | \n",
+ " Black Friday | \n",
+ " 2024-10-31 | \n",
+ " 2024-08-31 | \n",
+ " 2470 | \n",
+ " 2669.942383 | \n",
+ " 1702.475342 | \n",
+ " 6026.477051 | \n",
+ " 1186.401123 | \n",
+ " 9684.828125 | \n",
+ " 2720.952148 | \n",
+ " 1544.865967 | \n",
+ " 10109.417969 | \n",
+ " 1245.863525 | \n",
+ " 16568.388672 | \n",
+ " 3487.294922 | \n",
+ " 2173.488525 | \n",
+ " 14791.955078 | \n",
+ " 1823.862305 | \n",
+ " 21830.517578 | \n",
+ "
\n",
+ " \n",
+ " | 2 | \n",
+ " Black Friday | \n",
+ " 2024-11-30 | \n",
+ " 2024-08-31 | \n",
+ " 11058 | \n",
+ " 18250.660156 | \n",
+ " 6540.333008 | \n",
+ " 40904.207031 | \n",
+ " 5253.758301 | \n",
+ " 60771.214844 | \n",
+ " 10829.052734 | \n",
+ " 3100.690918 | \n",
+ " 46892.488281 | \n",
+ " 2217.646240 | \n",
+ " 82391.531250 | \n",
+ " 18171.929688 | \n",
+ " 3252.875244 | \n",
+ " 29226.037109 | \n",
+ " 2109.260742 | \n",
+ " 36364.984375 | \n",
+ "
\n",
+ " \n",
+ " | 3 | \n",
+ " Black Friday | \n",
+ " 2024-12-31 | \n",
+ " 2024-08-31 | \n",
+ " 3548 | \n",
+ " 4402.217773 | \n",
+ " 1691.808838 | \n",
+ " 13211.523438 | \n",
+ " 1389.497559 | \n",
+ " 19762.287109 | \n",
+ " 4263.519531 | \n",
+ " 1263.565918 | \n",
+ " 20130.382812 | \n",
+ " 965.645996 | \n",
+ " 31476.011719 | \n",
+ " 4231.202637 | \n",
+ " 2607.727783 | \n",
+ " 15159.037109 | \n",
+ " 2197.693115 | \n",
+ " 23046.003906 | \n",
+ "
\n",
+ " \n",
+ " | 4 | \n",
+ " Black Friday | \n",
+ " 2025-01-31 | \n",
+ " 2024-08-31 | \n",
+ " 1724 | \n",
+ " 2146.665039 | \n",
+ " 1472.426514 | \n",
+ " 5104.978516 | \n",
+ " 1193.615723 | \n",
+ " 8313.676758 | \n",
+ " 2245.810791 | \n",
+ " 1725.767334 | \n",
+ " 7961.554688 | \n",
+ " 1563.152588 | \n",
+ " 12675.156250 | \n",
+ " 2244.092529 | \n",
+ " 1669.365234 | \n",
+ " 3507.727539 | \n",
+ " 1474.717285 | \n",
+ " 5319.474121 | \n",
+ "
\n",
+ " \n",
+ "
\n",
+ "
"
+ ]
+ },
+ "execution_count": 6,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "tcf.plot(df, cv_df.drop(columns=[\"cutoff\", \"y\"]), level=[90])\n"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "4757c778",
+ "metadata": {},
+ "source": [
+ "## Evaluate\n"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 8,
+ "id": "56e13034",
+ "metadata": {
+ "execution": {
+ "iopub.execute_input": "2026-09-23T20:21:36.976483Z",
+ "iopub.status.busy": "2026-09-23T20:21:36.976307Z",
+ "iopub.status.idle": "2026-09-23T20:21:37.017400Z",
+ "shell.execute_reply": "2026-09-23T20:21:37.017196Z"
+ }
+ },
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "\n",
+ "\n",
+ "
\n",
+ " \n",
+ " \n",
+ " | metric | \n",
+ " mase | \n",
+ " scaled_crps | \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
+ " | Granite-PatchTST-FM-r2 | \n",
+ " 1.299 | \n",
+ " 0.174 | \n",
+ "
\n",
+ " \n",
+ " | Granite-PatchTST-FM-r1 | \n",
+ " 1.560 | \n",
+ " 0.178 | \n",
+ "
\n",
+ " \n",
+ " | PatchTST-FM-r1 | \n",
+ " 1.802 | \n",
+ " 0.170 | \n",
+ "
\n",
+ " \n",
+ "
\n",
+ "