update-readme-usage

README.md

@@ -12,7 +12,9 @@ tags:
 
 # Chronos-Bolt⚡ (Base)
 
-Chronos-Bolt is a family of pretrained time series forecasting models which can be used for zero-shot forecasting. It is based on the [T5 encoder-decoder architecture](https://arxiv.org/abs/1910.10683) and has been trained on nearly 100 billion time series observations. It chunks the historical time series context into patches of multiple observations, which are then input into the encoder. The decoder then uses these representations to directly generate quantile forecasts across multiple future steps—a method known as direct multi-step forecasting. Chronos-Bolt models are up to 250 times faster and 20 times more memory-efficient than the [original Chronos](https://arxiv.org/abs/2403.07815) models of the same size.
+Chronos-Bolt is a family of pretrained time series forecasting models which can be used for zero-shot forecasting. It is based on the [T5 encoder-decoder architecture](https://arxiv.org/abs/1910.10683) and has been trained on nearly 100 billion time series observations. It chunks the historical time series context into patches of multiple observations, which are then input into the encoder. The decoder then uses these representations to directly generate quantile forecasts across multiple future steps—a method known as direct multi-step forecasting. Chronos-Bolt models are **more accurate**, up to **250 times faster** and **20 times more memory-efficient** than the [original Chronos](https://arxiv.org/abs/2403.07815) models of the same size.
+
+## Performance
 
 The following plot compares the inference time of Chronos-Bolt against the original Chronos models for forecasting 1024 time series with a context length of 512 observations and a prediction horizon of 64 steps.
 
@@ -43,12 +45,13 @@ Chronos-Bolt models are available in the following sizes.
 
 ## Usage
 
-A minimal example showing how to perform zero-shot inference using Chronos-Bolt with AutoGluon:
+### Zero-shot inference with Chronos-Bolt in AutoGluon
 
+Install the required dependencies.
 ```
 pip install autogluon
 ```
-
+Forecast with the Chronos-Bolt model.
 ```python
 from autogluon.timeseries import TimeSeriesPredictor, TimeSeriesDataFrame
 
@@ -64,6 +67,40 @@ predictor = TimeSeriesPredictor(prediction_length=48).fit(
 predictions = predictor.predict(df)
 ```
 
+For more advanced features such as **fine-tuning** and **forecasting with covariates**, check out [this tutorial](https://auto.gluon.ai/stable/tutorials/timeseries/forecasting-chronos.html).
+
+### Deploying a Chronos-Bolt endpoint to SageMaker
+First, update the SageMaker SDK to make sure that all the latest models are available.
+```
+pip install -U sagemaker
+```
+Deploy an inference endpoint to SageMaker.
+```python
+from sagemaker.jumpstart.model import JumpStartModel
+
+model = JumpStartModel(
+    model_id="autogluon-forecasting-chronos-bolt-base",
+    instance_type="ml.m5.2xlarge",
+)
+predictor = model.deploy()
+```
+Now you can send time series data to the endpoint in JSON format.
+```python
+import pandas as pd
+df = pd.read_csv("https://raw.githubusercontent.com/AileenNielsen/TimeSeriesAnalysisWithPython/master/data/AirPassengers.csv")
+
+payload = {
+    "inputs": [
+        {"target": df["#Passengers"].tolist()}
+    ],
+    "parameters": {
+        "prediction_length": 12,
+    }
+}
+forecast = predictor.predict(payload)["predictions"]
+```
+Chronos-Bolt models can be deployed to both CPU and GPU instances. These models also support **forecasting with covariates**. For more details about the endpoint API, check out the [example notebook](https://github.com/aws/amazon-sagemaker-examples/blob/default/%20%20%20%20generative_ai/sm-jumpstart_time_series_forecasting.ipynb).
+
 ## Citation
 
 If you find Chronos or Chronos-Bolt models useful for your research, please consider citing the associated [paper](https://arxiv.org/abs/2403.07815):