**Red Coast** (redco) is a lightweight and user-friendly tool designed to automate distributed training and inference for large models while simplifying the ML pipeline development process without necessitating MLSys expertise from users.
RedCoast supports *Large Models* + *Complex Algorithms*, in a *lightweight* and *user-friendly* manner:
* Large Models beyond Transformers, e.g, [Stable Diffusion](https://github.com/tanyuqian/redco/tree/master/examples/text_to_image), etc.
* Complex algorithms beyond cross entropy, e.g., [Meta Learning](https://github.com/tanyuqian/redco/tree/master/examples/meta_learning), [Differentially-Private (DP) Training](https://github.com/tanyuqian/redco/tree/master/examples/differential_private_training), etc.
Check out our [Tech Report](https://aclanthology.org/2024.naacl-demo.14/) for more details!
**RedCoast: A Lightweight Tool to Automate Distributed Training of LLMs on Any GPU/TPUs** \
Bowen Tan, Yun Zhu, Lijuan Liu, Hongyi Wang, Yonghao Zhuang, Jindong Chen, Eric Xing, Zhiting Hu \
NAACL 2024, Demo / MLSys Workshop @ NeurIPS 2023 \
[[Paper]](https://aclanthology.org/2024.naacl-demo.14/)
[[Twitter]](https://x.com/BowenTan8/status/1730240627068031295?s=20)
[[Slides]](https://drive.google.com/file/d/1MmBjxP5gInqhg0ydasby2a5UauLZFxQH/view)
[[Demo Video]](https://bowentan.bitcron.com/RedCoast_demo.webm)
[[Documentation]](https://tanyuqian.github.io/redco) \
*Best Demo Paper Runner Up @ NAACL 2024*
### Installation
#### Install RedCoast
```
pip install redco
```
#### Adjust Jax to GPU/TPU version
The command above would automatically install cpu version of jax, so the version of Jax need to be adjusted based on your device.
For example, on GPUs,
```
pip install --upgrade "jax[cuda12]"
```
If you are using TPU/CPU/AMD/Apple, see [here](https://github.com/google/jax#installation) for corresponding installation commands.
### Examples
Examples across a set of paradigms can be found in [examples/](examples/), including
* [Classification/regression (GLUE & MNIST)](https://github.com/tanyuqian/redco/tree/master/examples/classification_regression)
* [Faderated learning (FedAvg)](https://github.com/tanyuqian/redco/tree/master/examples/faderated_learning)
* [Image to text (Image captioning)](https://github.com/tanyuqian/redco/tree/master/examples/image_to_text)
* [Language modeling (Instruction Tuning of LLMs)](https://github.com/tanyuqian/redco/tree/master/examples/language_modeling)
* [Meta learning (MAML)](https://github.com/tanyuqian/redco/tree/master/examples/meta_learning)
* [Reinforcement learning (PPO & DDPG)](https://github.com/tanyuqian/redco/tree/master/examples/reinforcement_learning)
* [Text to image (StableDiffusion)](https://github.com/tanyuqian/redco/tree/master/examples/text_to_image)
* [Text to text (Seq2seq)](https://github.com/tanyuqian/redco/tree/master/examples/text_to_text)
### Exemplar large model settings
The table below shows runnable model LLM finetuning on different kinds of servers. Numbers inside the brackets are the maximum length in training. All the settings are with full precision (fp32) and Adam optimizer.
| 2 $\times$ 1080Ti <br/>(2 $\times$ 10G) | 4 $\times$ A100 <br/>(4 $\times$ 40G) | 2 $\times$ TPU-v4 <br/>(2 hosts $\times$ 4 chips $\times$ 32G) | 16 $\times$ TPU-v4 <br/>(16 hosts $\times$ 4 chips $\times$ 32G) |
|-----------------------------------------|---------------------------------------|----------------------------------------------------------------|------------------------------------------------------------------|
| BART-Large (1024) | LLaMA-7B (1024) | T5-XL-11B (512) | OPT-66B (512) |
| GPT2-Large (512) | GPT-J-6B (1024) | OPT-13B (1024) | |
Go to [example/language_modeling](https://github.com/tanyuqian/redco/tree/master/examples/language_modeling) and [examples/text_to_text](https://github.com/tanyuqian/redco/tree/master/examples/text_to_text) to try them out!
## Reference
```
@inproceedings{tan-etal-2024-redcoast,
title = "{R}ed{C}oast: A Lightweight Tool to Automate Distributed Training of {LLM}s on Any {GPU}/{TPU}s",
author = "Tan, Bowen and
Zhu, Yun and
Liu, Lijuan and
Wang, Hongyi and
Zhuang, Yonghao and
Chen, Jindong and
Xing, Eric and
Hu, Zhiting",
editor = "Chang, Kai-Wei and
Lee, Annie and
Rajani, Nazneen",
booktitle = "Proceedings of the 2024 Conference of the North American Chapter of the Association for Computational Linguistics: Human Language Technologies (Volume 3: System Demonstrations)",
month = jun,
year = "2024",
address = "Mexico City, Mexico",
publisher = "Association for Computational Linguistics",
url = "https://aclanthology.org/2024.naacl-demo.14",
pages = "137--147",
abstract = "The recent progress of AI can be largely attributed to large language models (LLMs). However, their escalating memory requirements introduce challenges for machine learning (ML) researchers and engineers. Addressing this requires developers to partition a large model to distribute it across multiple GPUs or TPUs. This necessitates considerable coding and intricate configuration efforts with existing model parallel tools, such as Megatron-LM, DeepSpeed, and Alpa. These tools require users{'} expertise in machine learning systems (MLSys), creating a bottleneck in LLM development, particularly for developers without MLSys background. In this work, we present RedCoast (Redco), a lightweight and user-friendly tool crafted to automate distributed training and inference for LLMs, as well as to simplify ML pipeline development. The design of Redco emphasizes two key aspects. Firstly, to automate model parallelism, our study identifies two straightforward rules to generate tensor parallel strategies for any given LLM. Integrating these rules into Redco facilitates effortless distributed LLM training and inference, eliminating the need of additional coding or complex configurations. We demonstrate the effectiveness by applying Redco on a set of LLM architectures, such as GPT-J, LLaMA, T5, and OPT, up to the size of 66B. Secondly, we propose a mechanism that allows for the customization of diverse ML pipelines through the definition of merely three functions, avoiding redundant and formulaic code like multi-host related processing. This mechanism proves adaptable across a spectrum of ML algorithms, from foundational language modeling to complex algorithms like meta-learning and reinforcement learning. As a result, Redco implementations exhibit significantly fewer lines of code compared to their official counterparts. RedCoast (Redco) has been released under Apache 2.0 license at https://github.com/tanyuqian/redco.",
}
```
## Acknowledgement
The name of this package is inspired by *Red Coast Base*, a key location in the story of *Three Body*. From Red Coast Base, humanity broadcasts its first message into the vast universe. We thank Cixin Liu for such a masterpiece!
Raw data
{
"_id": null,
"home_page": "https://github.com/tanyuqian/redco",
"name": "redco",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Bowen Tan",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/47/48/38ae814cf7837f9c82565110e78e58f79cb886e7b74e406a6dc42550a210/redco-0.4.22.tar.gz",
"platform": null,
"description": "\n\n**Red Coast** (redco) is a lightweight and user-friendly tool designed to automate distributed training and inference for large models while simplifying the ML pipeline development process without necessitating MLSys expertise from users.\n\nRedCoast supports *Large Models* + *Complex Algorithms*, in a *lightweight* and *user-friendly* manner: \n* Large Models beyond Transformers, e.g, [Stable Diffusion](https://github.com/tanyuqian/redco/tree/master/examples/text_to_image), etc.\n* Complex algorithms beyond cross entropy, e.g., [Meta Learning](https://github.com/tanyuqian/redco/tree/master/examples/meta_learning), [Differentially-Private (DP) Training](https://github.com/tanyuqian/redco/tree/master/examples/differential_private_training), etc.\n\nCheck out our [Tech Report](https://aclanthology.org/2024.naacl-demo.14/) for more details! \n\n**RedCoast: A Lightweight Tool to Automate Distributed Training of LLMs on Any GPU/TPUs** \\\nBowen Tan, Yun Zhu, Lijuan Liu, Hongyi Wang, Yonghao Zhuang, Jindong Chen, Eric Xing, Zhiting Hu \\\nNAACL 2024, Demo / MLSys Workshop @ NeurIPS 2023 \\\n[[Paper]](https://aclanthology.org/2024.naacl-demo.14/) \n[[Twitter]](https://x.com/BowenTan8/status/1730240627068031295?s=20) \n[[Slides]](https://drive.google.com/file/d/1MmBjxP5gInqhg0ydasby2a5UauLZFxQH/view) \n[[Demo Video]](https://bowentan.bitcron.com/RedCoast_demo.webm) \n[[Documentation]](https://tanyuqian.github.io/redco) \\\n*Best Demo Paper Runner Up @ NAACL 2024*\n\n\n\n\n### Installation\n\n#### Install RedCoast\n```\npip install redco\n```\n\n#### Adjust Jax to GPU/TPU version\nThe command above would automatically install cpu version of jax, so the version of Jax need to be adjusted based on your device. \nFor example, on GPUs,\n```\npip install --upgrade \"jax[cuda12]\"\n```\nIf you are using TPU/CPU/AMD/Apple, see [here](https://github.com/google/jax#installation) for corresponding installation commands.\n\n\n### Examples\n\nExamples across a set of paradigms can be found in [examples/](examples/), including\n\n* [Classification/regression (GLUE & MNIST)](https://github.com/tanyuqian/redco/tree/master/examples/classification_regression)\n* [Faderated learning (FedAvg)](https://github.com/tanyuqian/redco/tree/master/examples/faderated_learning)\n* [Image to text (Image captioning)](https://github.com/tanyuqian/redco/tree/master/examples/image_to_text)\n* [Language modeling (Instruction Tuning of LLMs)](https://github.com/tanyuqian/redco/tree/master/examples/language_modeling)\n* [Meta learning (MAML)](https://github.com/tanyuqian/redco/tree/master/examples/meta_learning)\n* [Reinforcement learning (PPO & DDPG)](https://github.com/tanyuqian/redco/tree/master/examples/reinforcement_learning)\n* [Text to image (StableDiffusion)](https://github.com/tanyuqian/redco/tree/master/examples/text_to_image)\n* [Text to text (Seq2seq)](https://github.com/tanyuqian/redco/tree/master/examples/text_to_text)\n\n### Exemplar large model settings\n\nThe table below shows runnable model LLM finetuning on different kinds of servers. Numbers inside the brackets are the maximum length in training. All the settings are with full precision (fp32) and Adam optimizer.\n\n| 2 $\\times$ 1080Ti <br/>(2 $\\times$ 10G) | 4 $\\times$ A100 <br/>(4 $\\times$ 40G) | 2 $\\times$ TPU-v4 <br/>(2 hosts $\\times$ 4 chips $\\times$ 32G) | 16 $\\times$ TPU-v4 <br/>(16 hosts $\\times$ 4 chips $\\times$ 32G) |\n|-----------------------------------------|---------------------------------------|----------------------------------------------------------------|------------------------------------------------------------------|\n| BART-Large (1024) | LLaMA-7B (1024) | T5-XL-11B (512) | OPT-66B (512) |\n| GPT2-Large (512) | GPT-J-6B (1024) | OPT-13B (1024) | |\n\nGo to [example/language_modeling](https://github.com/tanyuqian/redco/tree/master/examples/language_modeling) and [examples/text_to_text](https://github.com/tanyuqian/redco/tree/master/examples/text_to_text) to try them out!\n\n\n## Reference\n```\n@inproceedings{tan-etal-2024-redcoast,\n title = \"{R}ed{C}oast: A Lightweight Tool to Automate Distributed Training of {LLM}s on Any {GPU}/{TPU}s\",\n author = \"Tan, Bowen and\n Zhu, Yun and\n Liu, Lijuan and\n Wang, Hongyi and\n Zhuang, Yonghao and\n Chen, Jindong and\n Xing, Eric and\n Hu, Zhiting\",\n editor = \"Chang, Kai-Wei and\n Lee, Annie and\n Rajani, Nazneen\",\n booktitle = \"Proceedings of the 2024 Conference of the North American Chapter of the Association for Computational Linguistics: Human Language Technologies (Volume 3: System Demonstrations)\",\n month = jun,\n year = \"2024\",\n address = \"Mexico City, Mexico\",\n publisher = \"Association for Computational Linguistics\",\n url = \"https://aclanthology.org/2024.naacl-demo.14\",\n pages = \"137--147\",\n abstract = \"The recent progress of AI can be largely attributed to large language models (LLMs). However, their escalating memory requirements introduce challenges for machine learning (ML) researchers and engineers. Addressing this requires developers to partition a large model to distribute it across multiple GPUs or TPUs. This necessitates considerable coding and intricate configuration efforts with existing model parallel tools, such as Megatron-LM, DeepSpeed, and Alpa. These tools require users{'} expertise in machine learning systems (MLSys), creating a bottleneck in LLM development, particularly for developers without MLSys background. In this work, we present RedCoast (Redco), a lightweight and user-friendly tool crafted to automate distributed training and inference for LLMs, as well as to simplify ML pipeline development. The design of Redco emphasizes two key aspects. Firstly, to automate model parallelism, our study identifies two straightforward rules to generate tensor parallel strategies for any given LLM. Integrating these rules into Redco facilitates effortless distributed LLM training and inference, eliminating the need of additional coding or complex configurations. We demonstrate the effectiveness by applying Redco on a set of LLM architectures, such as GPT-J, LLaMA, T5, and OPT, up to the size of 66B. Secondly, we propose a mechanism that allows for the customization of diverse ML pipelines through the definition of merely three functions, avoiding redundant and formulaic code like multi-host related processing. This mechanism proves adaptable across a spectrum of ML algorithms, from foundational language modeling to complex algorithms like meta-learning and reinforcement learning. As a result, Redco implementations exhibit significantly fewer lines of code compared to their official counterparts. RedCoast (Redco) has been released under Apache 2.0 license at https://github.com/tanyuqian/redco.\",\n}\n```\n\n## Acknowledgement\n\n\nThe name of this package is inspired by *Red Coast Base*, a key location in the story of *Three Body*. From Red Coast Base, humanity broadcasts its first message into the vast universe. We thank Cixin Liu for such a masterpiece!\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": null,
"version": "0.4.22",
"project_urls": {
"Homepage": "https://github.com/tanyuqian/redco"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ad0f317793b2d082d12bd493249bfefe1631962d2bea177e85560d3d3a2a3951",
"md5": "6df96bf5d916ff2dcbd7aba328bc8ad4",
"sha256": "ce1347fe91fca92c7f60e1a962148648ff4602729a0ae1a62f6db281a012e5c5"
},
"downloads": -1,
"filename": "redco-0.4.22-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6df96bf5d916ff2dcbd7aba328bc8ad4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 31187,
"upload_time": "2024-08-21T17:23:33",
"upload_time_iso_8601": "2024-08-21T17:23:33.899340Z",
"url": "https://files.pythonhosted.org/packages/ad/0f/317793b2d082d12bd493249bfefe1631962d2bea177e85560d3d3a2a3951/redco-0.4.22-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "474838ae814cf7837f9c82565110e78e58f79cb886e7b74e406a6dc42550a210",
"md5": "ca08216e6b5897a6f71d9d569b02c27c",
"sha256": "8956190c5cbd9aafd73c5df210d978ac69b325a83d10e3309a2f68ef41671670"
},
"downloads": -1,
"filename": "redco-0.4.22.tar.gz",
"has_sig": false,
"md5_digest": "ca08216e6b5897a6f71d9d569b02c27c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25281,
"upload_time": "2024-08-21T17:23:35",
"upload_time_iso_8601": "2024-08-21T17:23:35.196281Z",
"url": "https://files.pythonhosted.org/packages/47/48/38ae814cf7837f9c82565110e78e58f79cb886e7b74e406a6dc42550a210/redco-0.4.22.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-21 17:23:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tanyuqian",
"github_project": "redco",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "redco"
}
JSON
