# tsfm

**Repository Path**: gengzg/tsfm

## Basic Information

- **Project Name**: tsfm
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-02-22
- **Last Updated**: 2024-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tsfm
Public notebooks and utilities for working with Time Series Foundation Models (TSFM)

The core TSFM time series models have been made available on Hugging Face -- details can be found 
[here](wiki.md).


# Python Version
The current Python versions supported are 3.9 and 3.10.

## Initial Setup
First clone the repository:
```bash
git clone git@github.com:IBM/tsfm.git
cd tsfm
```

## Notebooks Installation
Several notebooks are provided in the `notebooks` folder. They allow you to perform pre-training and finetuning on the models.
To install use `pip`:

```bash
pip install ".[notebooks]"
```

### Notebooks links
- Getting started with `PatchTSMixer` [[Try it out]](https://github.com/IBM/tsfm/blob/main/notebooks/hfdemo/patch_tsmixer_getting_started.ipynb)
- Transfer learning with `PatchTSMixer` [[Try it out]](https://github.com/IBM/tsfm/blob/main/notebooks/hfdemo/patch_tsmixer_transfer.ipynb)
- Transfer learning with `PatchTST` [[Try it out]](https://github.com/IBM/tsfm/blob/main/notebooks/hfdemo/patch_tst_transfer.ipynb)


## Demos Installation
The demo presented at NeurIPS 2023 is available in `tsfmhfdemos`. This demo requires you to have pre-trained and finetuned models in place (we plan to release these at later date). To install the requirements use `pip`:

```bash
pip install ".[demos]"
```


## Issues
If you encounter an issue with this project, you are welcome to submit a [bug report](https://github.com/IBM/TSFM/issues).
Before opening a new issue, please search for similar issues. It's possible that someone has already reported it.


# Notice

The intention of this repository is to make it easier to use and demonstrate IBM Research TSFM components that have been made available in the [Hugging Face transformers library](https://huggingface.co/docs/transformers/main/en/index). As we continute to develop these capabilities we will update the code here.


IBM Public Repository Disclosure: All content in this repository including code has been provided by IBM under the associated open source software license and IBM is under no obligation to provide enhancements, updates, or support. IBM developers produced this code as an open source project (not as an IBM product), and IBM makes no assertions as to the level of quality nor security, and will not be maintaining this code going forward.