Update for README (#3)

- Update for README (e6404494223be6d9e115f5f03f0321b12bfa4e88)

README.md

@@ -10,13 +10,13 @@ Developed by: Replit, Inc.
 
 Replit Code v1.5 is a 3.3B parameter Causal Language Model focused on **Code Completion**.
 
-The model is trained on 1T tokens of code (~200B tokens  over 5 epochs, including linear cooldown) for 30 programming languages from a subset of permissively licensed code from Bigcode's [Stack Dedup V2 dataset](https://huggingface.co/datasets/bigcode/the-stack-dedup).
+The model is trained in `bfloat16` on 1T tokens of code (~200B tokens  over 5 epochs, including linear cooldown) for 30 programming languages from a subset of permissively licensed code from Bigcode's [Stack Dedup V2 dataset](https://huggingface.co/datasets/bigcode/the-stack-dedup) and a dev-oriented samples from StackExchange. 
+The context size is 4096 tokens can be extended using techniques on its ALiBi positional embeddings. 
 
-We use the GPTNeoX tokenizer with a custom trained and optimized vocabulary of 32768 tokens that led to single-digit % points on compression while maintaining or improving coverage on our training corpus.
+We use the GPTNeoX tokenizer with a custom trained and optimized vocabulary of 32768 tokens. This custom vocabulary led to single-digit % points on compression while maintaining or improving coverage on our training corpus.
 
 The model has been trained on the [MosaicML](https://www.mosaicml.com/) platform on 128  H100-80GB GPUs.
 
-The model has a context window size of 4096 tokens.
 
 ## Dependancies
 You will need to install the latest versions of the following dependencies:
@@ -26,9 +26,57 @@ torch
 transformers
 ```
 
-## How to Use (Coming Soon!)
+## How to Use
 
-(Details and code examples coming soon!)
+### Generation
+
+You can generate code using the `transformers` library as follows:
+
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+tokenizer = AutoTokenizer.from_pretrained('replit/replit-code-v1_5-3b', trust_remote_code=True)
+model = AutoModelForCausalLM.from_pretrained('replit/replit-code-v1_5-3b', trust_remote_code=True)
+
+x = tokenizer.encode('def fibonacci(n): ', return_tensors='pt')
+y = model.generate(x, max_length=100, do_sample=True, top_p=0.95, top_k=4, temperature=0.2, num_return_sequences=1, eos_token_id=tokenizer.eos_token_id)
+
+# decoding
+generated_code = tokenizer.decode(y[0], skip_special_tokens=True, clean_up_tokenization_spaces=False)
+print(generated_code)
+```
+
+Experiment with different decoding methods and parameters to get the best results for your use case.
+
+### Using Triton Implementation of Flash Attention
+
+```python
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM, AutoConfig
+
+config = AutoConfig.from_pretrained(
+    "replit/replit-code-v1_5-3b",
+    trust_remote_code=True
+)
+config.attn_config['attn_impl'] = 'triton'
+
+# load model
+tokenizer = AutoTokenizer.from_pretrained('replit/replit-code-v1_5-3b', trust_remote_code=True)
+model = AutoModelForCausalLM.from_pretrained('replit/replit-code-v1_5-3b', config=config, trust_remote_code=True)
+model.to(device='cuda:0', dtype=torch.bfloat16)
+
+# forward pass
+x = tokenizer.encode('def fibonacci(n): ', return_tensors='pt').to(device='cuda:0')
+x = x.to(device='cuda:0')
+y = model.generate(x, max_length=100, do_sample=True, top_p=0.95, top_k=4, temperature=0.2, num_return_sequences=1, eos_token_id=tokenizer.eos_token_id)
+
+
+# decoding
+generated_code = tokenizer.decode(y[0], skip_special_tokens=True, clean_up_tokenization_spaces=False)
+print(generated_code)
+```
+
+Experiment with different decoding methods and parameters to get the best results for your use case. We recommend experimenting with `temperature` and `reptition_penalty`for optimal performance on your use case!
 
 ## Intended Use
 
@@ -36,5 +84,7 @@ Replit intends this model be used by anyone as a foundational model for applicat
 
 The model is trained specifically for code completion tasks.
 
+
+
 ## Limitations
-The pre-training dataset may have contained offensive or inappropriate content even after applying data cleansing filters, and such content may be reflected in model generated text. We recommend that users exercise reasonable caution when using in production systems. Do not use for any applications that may cause harm or distress to individuals or groups.
+The pre-training dataset may have contained offensive or inappropriate content even after applying data cleansing and toxicity and profanity filters, and such content may be reflected in model generated text. We recommend that users exercise reasonable caution when using in production systems. Do not use for any applications that may cause harm or distress to individuals or groups.