File size: 4,353 Bytes
138d7dc 1e66110 138d7dc be98e89 138d7dc be98e89 138d7dc be98e89 138d7dc be98e89 138d7dc 49c56d5 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 |
---
license: apache-2.0
library_name: transformers
pipeline_tag: text-generation
base_model:
- Qwen/Qwen2.5-14B-Instruct
datasets:
- ChatTSRepo/ChatTS-Training-Dataset
language:
- zho
- eng
- fra
- spa
- por
- deu
- ita
- rus
- jpn
- kor
- vie
- tha
- ara
---
# [VLDB' 25] ChatTS-14B Model
<div style="display:flex;justify-content: center">
<a href="https://github.com/NetmanAIOps/ChatTS"><img alt="github" src="https://img.shields.io/badge/Code-GitHub-blue"></a>
<a href="https://arxiv.org/abs/2412.03104"><img alt="preprint" src="https://img.shields.io/static/v1?label=arXiv&message=2412.03104&color=B31B1B&logo=arXiv"></a>
</div>
**[VLDB' 25] ChatTS: Aligning Time Series with LLMs via Synthetic Data for Enhanced Understanding and Reasoning**
`ChatTS` focuses on **Understanding and Reasoning** about time series, much like what vision/video/audio-MLLMs do.
This repo provides code, datasets and model for `ChatTS`: [ChatTS: Aligning Time Series with LLMs via Synthetic Data for Enhanced Understanding and Reasoning](https://arxiv.org/pdf/2412.03104).
## Web Demo
The Web Demo of ChatTS-14B is available at HuggingFace Spaces: [](https://huggingface.co/spaces/xiezhe22/ChatTS)
## Key Features
ChatTS is a Multimodal LLM built natively for time series as a core modality：
- ✅ **Native support for multivariate time series**
- ✅ **Flexible input**: Supports multivariate time series with **different lengths** and **flexible dimensionality**
- ✅ **Conversational understanding + reasoning**:
Enables interactive dialogue over time series to explore insights about time series
- ✅ **Preserves raw numerical values**:
Can answer **statistical questions**, such as _"How large is the spike at timestamp t?"_
- ✅ **Easy integration with existing LLM pipelines**, including support for **vLLM**.
### Example Application
Here is an example of a ChatTS application, which allows users to interact with a LLM to understand and reason about time series data:
[Link to the paper](https://arxiv.org/pdf/2412.03104)
[Link to the Github repository](https://github.com/NetManAIOps/ChatTS)
## Usage
- This model is fine-tuned on the QWen2.5-14B-Instruct (https://huggingface.co/Qwen/Qwen2.5-14B-Instruct) model. For more usage details, please refer to the `README.md` in the ChatTS repository.
- An example usage of ChatTS (with `HuggingFace`):
```python
from transformers import AutoModelForCausalLM, AutoTokenizer, AutoProcessor
import torch
import numpy as np
hf_model = "bytedance-research/ChatTS-14B"
# Load the model, tokenizer and processor
# For pre-Ampere GPUs (like V100) use `_attn_implementation='eager'`
model = AutoModelForCausalLM.from_pretrained(hf_model, trust_remote_code=True, device_map="auto", torch_dtype='float16')
tokenizer = AutoTokenizer.from_pretrained(hf_model, trust_remote_code=True)
processor = AutoProcessor.from_pretrained(hf_model, trust_remote_code=True, tokenizer=tokenizer)
# Create time series and prompts
timeseries = np.sin(np.arange(256) / 10) * 5.0
timeseries[100:] -= 10.0
prompt = f"I have a time series length of 256: <ts><ts/>. Please analyze the local changes in this time series."
# Apply Chat Template
prompt = f"""<|im_start|>system
You are a helpful assistant.<|im_end|><|im_start|>user
{prompt}<|im_end|><|im_start|>assistant
"""
# Convert to tensor
inputs = processor(text=[prompt], timeseries=[timeseries], padding=True, return_tensors="pt")
# Model Generate
outputs = model.generate(**inputs, max_new_tokens=300)
print(tokenizer.decode(outputs[0][len(inputs['input_ids'][0]):], skip_special_tokens=True))
```
## Reference
- QWen2.5-14B-Instruct (https://huggingface.co/Qwen/Qwen2.5-14B-Instruct)
- transformers (https://github.com/huggingface/transformers.git)
- [ChatTS Paper](https://arxiv.org/pdf/2412.03104)
## License
This model is licensed under the [Apache License 2.0](LICENSE).
## Cite
```
@article{xie2024chatts,
title={ChatTS: Aligning Time Series with LLMs via Synthetic Data for Enhanced Understanding and Reasoning},
author={Xie, Zhe and Li, Zeyan and He, Xiao and Xu, Longlong and Wen, Xidao and Zhang, Tieying and Chen, Jianjun and Shi, Rui and Pei, Dan},
journal={arXiv preprint arXiv:2412.03104},
year={2024}
}
``` |