feat: updated README

README.md

@@ -1,3 +1,91 @@
 ---
+language: 
+  - en
+tags:
+  - deepspeed
+  - chatgpt
+  - opt
+  - sft
+  - rlhf
 license: apache-2.0
 ---
+---
+
+# ChatGPT OPT 1.3B DeepSpeed Reinforcement Learning from Human feedback
+
+*fsalab-chat-opt-1.3b-rlhf-deepspeed*
+
+This model consists of the final step of a modified pipeline the to the traditional training process of Chat-GPT models, which is comprised of a three-step procedure of [supervised fine tuning](https://huggingface.co/FSALab/fsalab-chat-opt-1.3b-sft-deepspeed), [reward model](https://huggingface.co/FSALab/fsalab-chat-opt-350m-reward-deepspeed) and **reinforcement learning from human feedback**.
+
+This project's main goal was to make proper use of existing frameworks that revolve around the minimisation of training costs and thus the eventual improvements towards both the feasibility and usability of ChatGPT-like models. The framework selected here is DeepSpeed which has been instrumental in the development of this model and through this framework it was possible to train the ChatGPT-like model on much larger data-sets with a reasonable number of GPUs and consequently achieve significantly better performance.
+
+This model follows the blog of ChatGPT and the paper of InstructGPT and especially the [Microsoft DeepSpeed Chat Blog](https://github.com/microsoft/DeepSpeedExamples/tree/master/applications/DeepSpeed-Chat).
+
+## Our Training Methodology and Speedup Recipes
+
+This training process is broken up into three key steps:
+
+1. **Supervised fine-tuning (SFT):** See [here](https://huggingface.co/FSALab/fsalab-chat-opt-1.3b-sft-deepspeed)
+
+2. **Reward Model (RM) fine-tuning:** See [here](https://huggingface.co/FSALab/fsalab-chat-opt-350m-reward-deepspeed) 
+
+3. **Reinforcement-learning from Human feedback (RLHF) fine-tuning:** At the completion of the prior two steps, the final RLHF fine-tuning can be initiated. This involves the collection of both the *fine-tuned model* from step 1 and the *reward model** from step 2 and train them on the data-set with comparisons. 
+
+To view the details behind each step head into their respective links and view the model card there.
+  
+### Reinforcement learning from human feedback
+
+**Model Configurations:**
+
+| Parameter              | Value |
+|:-----------------------|:------|
+| Parameters             | 1.3B   |
+| Model type             | OPT   |
+| FFN Dimensions         | 8192  |
+| Hidden Size            | 2048  |
+| Max Position Embedding | 2048  |
+| Attention Heads        | 16    |
+| Hidden layers          | 24    |
+
+
+**Training Configurations:**
+| Parameter              | Value |
+|:-----------------------|:------|
+| Train Batch size       | 32    |
+| Train micro batch size | 4     |
+| ZeRO stage             | 2     |
+| FP16                   | True  |
+| Gradient clipping      | 1.0   |
+| Dropout                | 0.1   |
+| Attention Dropout      | 0.0   |
+| Attention Dropout      | 0.0   |
+| Prescale gradients     | False  |
+
+
+
+## Why did we choose DeepSpeed?
+
+**DeepSpeed Training:** 
+
+The `main.py` Python code take the DeepSpeed config with the argument `--deepspeed_config ./ds_config.json`.
+
+We read up on the DeepSpeed documentation and created a specific coniguration based on their work. The json file `ds_config.json` here is set to take the [ZeRO-2](https://www.microsoft.com/en-us/research/blog/ZeRO-2-deepspeed-shattering-barriers-of-deep-learning-speed-scale/) stage and FP16, allowing must faster training and GPU memory saving. Note that ZeRO-2 is just one of the examples using our DeepSpeed. You may use ZeRO-1, Zero-3, ZeRO-Offload and ZeRO-infinity. For more information on DeepSpeed ZeRO family, please see this [tutorial link](https://www.deepspeed.ai/tutorials/zero/) for Zero-1/2/3 and this [tutorial ](https://www.deepspeed.ai/tutorials/zero-offload/)for Zero-Offload.
+
+To enable the DeepSpeed Zero family training, we injected several lines of code in order to enable this i.e.:
+
+```python
+model, optimizer, _, lr_scheduler = deepspeed.initialize(model=model, \
+  optimizer=optimizer, \
+  args=args,       \
+  lr_scheduler=lr_scheduler,  \
+  dist_init_required=True)
+```
+
+
+## **Acknowledgements**
+
+We thank the following papers and open-source repositories. We especially thank DeepSpeed for their frameworks as well.
+
+* [1] Schulman, John, et al. "Introducing ChatGPT", https://openai.com/blog/chatgpt (2022).
+* [2] Transformers [Hugging Face (github.com)](https://github.com/huggingface)
+* [3] DeepSpeed Chat [DeepSpeed Chat](https://github.com/microsoft/DeepSpeedExamples/tree/master/applications/DeepSpeed-Chat)