Update README.md

README.md

@@ -1,5 +1,50 @@
----
-license: other
-license_name: open-aleph-license
-license_link: LICENSE
----
+---
+license: other
+license_name: open-aleph-license
+license_link: LICENSE
+library_name: scaling
+pipeline_tag: text-generation
+---
+
+
+![image/png](https://cdn-uploads.huggingface.co/production/uploads/671a0238b080a748c29b8fea/v1rfcKVaL8vnjuCqWUmI-.png)
+
+
+# u-μP: Stable training in low precision for a significant speed-up and memory reduction during training
+
+
+![image/png](https://cdn-uploads.huggingface.co/production/uploads/671a0238b080a748c29b8fea/F1-zbAXF5LGvxpIRrYfU4.png)
+
+
+This Repository holds the model weights for the 7B u-μP models trained at Aleph Alpha Research, in collaboration with Graphcore, for 72k steps (300B tokens). Please note, that the released checkpoints are not fully converged models and are intended for research use only.
+
+You can find all model weights and their corresponding safetensors conversions at the following links:
+- [umup-research-7b-bf16](https://huggingface.co/Aleph-Alpha/umup-research-7b-bf16)
+- [umup-research-7b-fp8](https://huggingface.co/Aleph-Alpha/umup-research-7b-fp8)
+- [sp-baseline-research-7b-bf16](https://huggingface.co/Aleph-Alpha/sp-baseline-research-7b-bf16)
+
+The Maximal Update Parametrization (μP) aims to make the optimal hyperparameters (HPs) of a model-independent of its size, allowing them to be swept using a cheap proxy model rather than the full-size target model. We present a new scheme, u-μP, which improves upon μP by combining it with Unit Scaling, a method for designing models that makes them easy to train in low precision. The two techniques have a natural affinity: μP ensures that the scale of activations is independent of model size, and Unit Scaling ensures that activations, weights, and gradients begin training with a scale of one. This synthesis opens the door to a simpler scheme, whose default values are near-optimal. This in turn facilitates a more efficient sweeping strategy, with u-μP models reaching a lower loss than comparable μP models and working out-of-the-box in FP8.
+
+
+
+If you want to learn more details about u-μP, check out our [blog post](https://aleph-alpha.com/in-awe-at-the-scale-of-these-tensors-a-gentle-introduction-to-unit-scaled-maximal-update-parametrization/) and our [paper](https://arxiv.org/abs/2407.17465).
+
+Unit-Scaled Maximal Update Parametrization (u-μP) is available in [Scaling](https://github.com/Aleph-Alpha/scaling), our official large-scale training codebase. Please note, that FP8-trained checkpoints only work on chips with FP8 support, like the Hopper architecture. 
+
+# Usage
+You can generate tokens with the [Scaling](https://github.com/Aleph-Alpha/scaling) inference implementation:
+
+```python
+from scaling.transformer.inference import TransformerInferenceModule
+from pathlib import Path
+
+ckpt_path = Path("<path_to_repo>/umup-research-7b-bf16")
+
+model = TransformerInferenceModule.from_checkpoint(ckpt_path)
+
+prompt = "Yesterday I dreamt of "
+
+output = model.generate(max_tokens=100, input_text=prompt)
+
+print(output.completion_text)
+```