[FEAT] Readme update (#346)

Co-authored-by: azul <fede.garza.ramirez@gmail.com>
Co-authored-by: Mariana Menchero García <47995617+MMenchero@users.noreply.github.com>
Co-authored-by: Marco <marco@nixtla.io>

README.md

@@ -1,55 +1,195 @@
-# Nixtla   [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Statistical%20Forecasting%20Algorithms%20by%20Nixtla%20&url=https://github.com/Nixtla/statsforecast&via=nixtlainc&hashtags=StatisticalModels,TimeSeries,Forecasting)  [![Slack](https://img.shields.io/badge/Slack-4A154B?&logo=slack&logoColor=white)](https://join.slack.com/t/nixtlacommunity/shared_invite/zt-1pmhan9j5-F54XR20edHk0UtYAPcW4KQ)
+# Nixtla   [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Statistical%20Forecasting%20Algorithms%20by%20Nixtla%20&url=https://github.com/Nixtla/neuralforecast&via=nixtlainc&hashtags=StatisticalModels,TimeSeries,Forecasting)  [![Slack](https://img.shields.io/badge/Slack-4A154B?&logo=slack&logoColor=white)](https://join.slack.com/t/nixtlacommunity/shared_invite/zt-1pmhan9j5-F54XR20edHk0UtYAPcW4KQ)
 
 <div align="center">
-<img src="https://raw.githubusercontent.com/Nixtla/neuralforecast/main/nbs/imgs_indx/logo_mid.png">
-<h1 align="center">Nixtla</h1>
-<h3 align="center">Forecast using TimeGPT</h3>
-    
+<img src="https://raw.githubusercontent.com/Nixtla/neuralforecast/main/nbs/imgs_indx/logo_new.png">
+<h1 align="center">TimeGPT-1 </h1>
+<h3 align="center">The first foundation model for forecasting and anomaly detection</h3>
+
 [![CI](https://github.com/Nixtla/nixtla/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/Nixtla/nixtla/actions/workflows/ci.yaml)
-[![Python](https://img.shields.io/pypi/pyversions/nixtla)](https://pypi.org/project/nixtla/)
 [![PyPi](https://img.shields.io/pypi/v/nixtla?color=blue)](https://pypi.org/project/nixtla/)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/Nixtla/nixtla/blob/main/LICENSE)
-[![docs](https://img.shields.io/website-up-down-green-red/http/nixtla.github.io/nixtla.svg?label=docs)](https://nixtla.github.io/nixtla/)
+[![docs](https://img.shields.io/website-up-down-green-red/http/docs.nixtla.io/.svg?label=docs)](https://docs.nixtla.io)
 [![Downloads](https://pepy.tech/badge/nixtla)](https://pepy.tech/project/nixtla)
-
-**Nixtla** offers a collection of classes and methods to interact with the API of TimeGPT.
-</div>
-
-# 🕰️ TimeGPT: Revolutionizing Time-Series Analysis
+[![Downloads](https://pepy.tech/badge/nixtla/month)](https://pepy.tech/project/nixtla)
+[![Downloads](https://pepy.tech/badge/nixtla/week)](https://pepy.tech/project/nixtla)
 
-Developed by Nixtla, TimeGPT is a cutting-edge generative pre-trained transformer model dedicated to prediction tasks. 🚀 By leveraging the most extensive dataset ever – financial, weather, energy, and sales data – TimeGPT brings unparalleled time-series analysis right to your terminal! 👩‍💻👨‍💻
+**TimeGPT** is a production ready, generative pretrained transformer for time series. It's capable of accurately predicting various domains such as retail, electricity, finance, and IoT with just a few lines of code 🚀. </div>
 
-In seconds, TimeGPT can discern complex patterns and predict future data points, transforming the landscape of data science and predictive analytics.
+## 📖 Table of Contents
+- [Quick Start](#-quick-start)
+- [Installation](#install-nixtlas-sdk)
+- [Forecasting with TimeGPT](#forecast-using-timegpt-in-3-easy-steps)
+- [Anomaly Detection](#anomaly-detection-using-timegpt-in-3-easy-steps)
+- [Zero-shot Results](#️-zero-shot-results)
+- [How to Cite](#-how-to-cite)
+- [Features and Mentions](#-features-and-mentions)
+- [License](#-license)
+- [Get in Touch](#-get-in-touch)
 
-## ⚙️ Fine-Tuning: For Precision Prediction
 
-In addition to its core capabilities, TimeGPT supports fine-tuning, enhancing its specialization for specific prediction tasks. 🎯 This feature is like training a machine learning model on a targeted data subset to improve its task-specific performance, making TimeGPT an even more versatile tool for your predictive needs.
+## 🚀 Quick Start
 
-## 🔄 `Nixtla`: Your Gateway to TimeGPT
+https://github.com/Nixtla/nixtla/assets/4086186/163ad9e6-7a16-44e1-b2e9-dab8a0b7b6b6
 
-With `Nixtla`, you can easily interact with TimeGPT through simple API calls, making the power of TimeGPT readily accessible in your projects.
 
-## 💻 Installation
-
-Get `Nixtla` up and running with a simple pip command:
 
+### Install nixtla's SDK
 ```python
 pip install nixtla>=0.5.1
 ```
 
-## 🎈 Quick Start
+### Import libraries and load data
+``` python
+import pandas as pd
+from nixtla import NixtlaClient
+```
+###  Forecast using TimeGPT in 3 easy steps
+```python
+# Get your API Key at dashboard.nixtla.io
 
-Get started with TimeGPT now:
+# 1. Instantiate the NixtlaClient
+nixtla_client = NixtlaClient(api_key = 'YOUR API KEY HERE')
 
-```python
+# 2. Read historic electricity demand data 
 df = pd.read_csv('https://raw.githubusercontent.com/Nixtla/transfer-learning-time-series/main/datasets/electricity-short.csv')
 
-from nixtla import NixtlaClient
-nixtla_client = NixtlaClient(
-    # defaults to os.environ.get("NIXTLA_API_KEY")
-    api_key = 'my_api_key_provided_by_nixtla'
-)
+# 3. Forecast the next 24 hours
 fcst_df = nixtla_client.forecast(df, h=24, level=[80, 90])
+
+# 4. Plot your results (optional)
+nixtla_client.plot(df, timegpt_fcst_df, time_col='timestamp', target_col='value', level=[80, 90])
+
+```
+![Forecast Results](./nbs/img/forecast_readme.png)
+
+###  Anomaly detection using TimeGPT in 3 easy steps
+```python
+# Get your API Key at dashboard.nixtla.io
+
+# 1. Instantiate the NixtlaClient
+nixtla_client = NixtlaClient(api_key = 'YOUR API KEY HERE')
+
+# 2. Read Data # Wikipedia visits of NFL Star (
+df = pd.read_csv('https://raw.githubusercontent.com/Nixtla/transfer-learning-time-series/main/datasets/peyton_manning.csv')
+
+
+# 3. Detect Anomalies 
+anomalies_df = nixtla_client.detect_anomalies(df, time_col='timestamp', target_col='value', freq='D')
+
+# 4. Plot your results (optional)
+nixtla_client.plot(df, anomalies_df,time_col='timestamp', target_col='value')
+```
+![AnomalyDetection](nbs/img/anomaly.png)
+
+## 🤓 API support for other languages
+Explore our [API Reference](https://docs.nixtla.io) to discover how to leverage TimeGPT across various programming languages including JavaScript, Go, and more.
+
+## 🔥 Features and Capabilities
+
+- **Zero-shot Inference**: TimeGPT can generate forecasts and detect anomalies straight out of the box, requiring no prior training data. This allows for immediate deployment and quick insights from any time series data.
+
+- **Fine-tuning**: Enhance TimeGPT's capabilities by fine-tuning the model on your specific datasets, enabling the model to adapt to the nuances of your unique time series data and improving performance on tailored tasks.
+
+- **API Access**: Integrate TimeGPT seamlessly into your applications via our robust API. Upcoming support for Azure Studio will provide even more flexible integration options. Alternatively, deploy TimeGPT on your own infrastructure to maintain full control over your data and workflows.
+
+- **Add Exogenous Variables**: Incorporate additional variables that might influence your predictions to enhance forecast accuracy. (E.g. Special Dates, events or prices)
+
+- **Multiple Series Forecasting**: Simultaneously forecast multiple time series data, optimizing workflows and resources.
+
+- **Custom Loss Function**: Tailor the fine-tuning process with a custom loss function to meet specific performance metrics.
+
+- **Cross Validation**: Implement out of the box cross-validation techniques to ensure model robustness and generalizability.
+
+- **Prediction Intervals**: Provide intervals in your predictions to quantify uncertainty effectively.
+
+- **Irregular Timestamps**: Handle data with irregular timestamps, accommodating non-uniform interval series without preprocessing.
+
+## 📚 Documentation with examples and use cases
+
+Dive into our [comprehensive documentation](https://docs.nixtla.io/docs/getting-started-timegpt_quickstart) to discover examples and practical use cases for TimeGPT. Our documentation covers a wide range of topics, including:
+
+- **Getting Started**: Begin with our user-friendly [Quickstart Guide](https://docs.nixtla.io/docs/getting-started-timegpt_quickstart) and learn how to [set up your API key](https://docs.nixtla.io/docs/getting-started-setting_up_your_api_key) effortlessly.
+
+- **Advanced Techniques**: Master advanced forecasting methods and learn how to enhance model accuracy with our tutorials on [anomaly detection](https://docs.nixtla.io/docs/tutorials-anomaly_detection), fine-tuning models using specific loss functions, and scaling computations across distributed frameworks such as [Spark, Dask, and Ray](https://docs.nixtla.io/docs/tutorials-computing_at_scale).
+
+- **Specialized Topics**: Explore specialized topics like [handling exogenous variables](https://docs.nixtla.io/docs/tutorials-holidays_and_special_dates), model validation through [cross-validation](https://docs.nixtla.io/docs/tutorials-cross_validation), and strategies for [forecasting under uncertainty](https://docs.nixtla.io/docs/tutorials-uncertainty_quantification).
+
+- **Real-World Applications**: Uncover how TimeGPT is applied in real-world scenarios through case studies on [forecasting web traffic](https://docs.nixtla.io/docs/use-cases-forecasting_web_traffic) and [predicting Bitcoin prices](https://docs.nixtla.io/docs/use-cases-bitcoin_price_prediction).
+
+
+
+## 🗞️ TimeGPT-1: Revolutionizing Forecasting and Anomaly Detection
+
+Time series data is pivotal across various sectors, including finance, healthcare, meteorology, and social sciences. Whether it's monitoring ocean tides or tracking the Dow Jones's daily closing values, time series data is crucial for forecasting and decision-making.
+
+Traditional analysis methods such as ARIMA, ETS, MSTL, Theta, CES, machine learning models like XGBoost and LightGBM, and deep learning approaches have been standard tools for analysts. However, TimeGPT introduces a paradigm shift with its standout performance, efficiency, and simplicity. Thanks to its zero-shot inference capability, TimeGPT streamlines the analytical process, making it accessible even to users with minimal coding experience.
+
+TimeGPT is user-friendly and low-code, enabling users to upload their time series data and either generate forecasts or detect anomalies with just a single line of code. As the only foundation model for time series analysis out of the box, TimeGPT can be integrated via our public APIs, through Azure Studio (coming soon), or deployed on your own infrastructure.
+
+## ⚙️ TimeGPT's Architecture
+Self-attention, the revolutionary concept introduced by the paper “Attention is all you need“, is the basis of the this foundational model. The TimeGPT model is not based on any existing large language model(LLMs). It is independently trained on vast timeseries dataset as a large transformer model and is designed so as to minimize the forecasting error.
+
+The architecture consists of an encoder-decoder structure with
+multiple layers, each with residual connections and layer normalization. Finally, a linear layer maps the decoder’s output to the forecasting window dimension. The general intuition is that attentionbased mechanisms are able to capture the diversity of past events and correctly extrapolate potential
+future distributions.
+
+![Arquitecture](nbs/img/forecast.png)
+
+
+TimeGPT was trained on, to our knowledge, the largest collection of publicly available time series,
+collectively encompassing over 100 billion data points. This training set incorporates time series
+from a broad array of domains, including finance, economics, demographics, healthcare, weather,
+IoT sensor data, energy, web traffic, sales, transport, and banking. Due to this diverse set of domains,
+the training dataset contains time series with a wide range of characteristics
+
+For the Zero-shot Results section of your README, you can enhance the clarity and effectiveness by focusing on emphasizing the key findings and their implications, while also making the text more concise and digestible. Here's a refined version:
+
+---
+
+## ⚡️ Zero-shot Results
+### Accuracy:
+TimeGPT has been tested for its zero-shot inference capabilities on more than 300K unique series, which involve using the model without additional fine-tuning on the test dataset. TimeGPT outperforms a comprehensive range of well-established statistical and cutting-edge deep learning models, consistently ranking among the top three performers across various frequencies.
+
+### Ease of use:
+TimeGPT also excels by offering simple and rapid predictions using a pre-trained model. This stands in stark contrast to other models that typically require an extensive training and prediction pipeline. 
+
+![Results](nbs/img/results.jpg)
+
+### Efficiency and Speed: 
+For zero-shot inference, our internal tests recorded an average GPU inference speed of 0.6 milliseconds per series for TimeGPT, which nearly mirrors that of the simple Seasonal Naive. 
+
+## 📝 How to cite?
+
+If you find TimeGPT useful for your research, please consider citing the associated [paper](https://arxiv.org/abs/2310.03589):
+
 ```
+@article{ansari2024chronos,
+@misc{garza2023timegpt1,
+      title={TimeGPT-1}, 
+      author={Azul Garza and Max Mergenthaler-Canseco},
+      year={2023},
+      eprint={2310.03589},
+      archivePrefix={arXiv},
+      primaryClass={cs.LG}
+}
+```
+
+## 🎉 Features and Mentions
+TimeGPT has been featured in many publications and has been recognized for its innovative approach to time series forecasting. Here are some of the features and mentions:
+
+- [TimeGPT Revolutionizing Time Series Forecasting](https://www.analyticsvidhya.com/blog/2024/02/timegpt-revolutionizing-time-series-forecasting/)
+- [TimeGPT: The First Foundation Model for Time Series Forecasting](https://towardsdatascience.com/timegpt-the-first-foundation-model-for-time-series-forecasting-bf0a75e63b3a)
+- [TimeGPT: Revolutionising Time Series Forecasting with Generative Models](https://medium.com/@22meera99/timegpt-revolutionising-time-series-forecasting-with-generative-models-86be6c09fa51)
+- [TimeGPT on Turing Post](https://www.turingpost.com/p/timegpt)
+- [TimeGPT Presentation at AWS Events](https://www.youtube.com/watch?v=5pYkT0rTCfE&ab_channel=AWSEvents)
+- [TimeGPT: Machine Learning for Time Series Made Accessible - Podcast](https://podcasts.apple.com/bg/podcast/timegpt-machine-learning-for-time-series-made-accessible/id1487704458?i=1000638551991)
+- [TimeGPT on The Data Exchange](https://thedataexchange.media/timegpt/)
+- [How TimeGPT Transforms Predictive Analytics with AI](https://hackernoon.com/how-timegpt-transforms-predictive-analytics-with-ai)
+- [TimeGPT: The First Foundation Model - AI Horizon Forecast](https://aihorizonforecast.substack.com/p/timegpt-the-first-foundation-model)
+
+
+## 🔖 License
+TimeGPT is closed source. However, this SDK is open source and available under the Apache 2.0 License. Feel free to contribute. 
 
-![](./nbs/img/forecast_readme.png)
+## 📞 Get in touch
+For any questions or feedback, please feel free to reach out to us at ops [at] nixtla.io.