initial release

.gitattributes

@@ -0,0 +1,3 @@
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.json filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,109 @@
+---
+language:
+  - en
+thumbnail: null
+tags:
+  - text generation
+  - instruct
+pipeline_tag: text-generation
+inference: false
+---
+<h1 style="text-align: center">Metharme 13B</h1>
+<h2 style="text-align: center">An instruction-tuned LLaMA biased towards fiction writing and conversation.</h2>
+
+## Model Details
+
+Metharme 13B is an instruct model based on Meta's LLaMA-13B.
+
+This is an experiment to try and get a model that is usable for conversation, roleplaying and storywriting, but which can be guided using natural language like other instruct models. See the [prompting](#prompting) section below for examples.
+
+It was trained by doing supervised fine-tuning over a mixture of regular instruction data alongside roleplay, fictional stories and conversations with synthetically generated instructions attached.
+
+## Applying the XORs
+
+The model weights in this repository cannot be used as-is. The files here are XORs due to licensing concerns. To obtain proper, usable model weights you need to:
+
+- Request access to the original LLaMA weights from Meta [through this form](https://docs.google.com/forms/d/e/1FAIpQLSfqNECQnMkycAp2jP4Z9TFX0cGR4uf7b_fBxjY_OjhJILlKGA/viewform?usp=send_form)
+- Convert them to the HuggingFace Transformers format by using the [convert_llama_weights_to_hf.py](https://github.com/huggingface/transformers/blob/849367ccf741d8c58aa88ccfe1d52d8636eaf2b7/src/transformers/models/llama/convert_llama_weights_to_hf.py) script **for your version of the `transformers` library**
+- With the LLaMA-13B weights in hand, you can use the [xor_codec.py](./xor_codec.py) script provided in this repository:
+
+  ```bash
+  python3 xor_codec.py \
+    ./metharme-13b \
+    ./xor_encoded_files \
+    /path/to/hf-converted/llama-13b \
+    --decode
+  ```
+
+For reference, these are the hashes you should get after following the steps above:
+
+```bash
+$ rhash --sha256 *
+85467905c66f9b86d07896fe55c5b1a6ba322ad9a73b53806e6b5e105831a71c  config.json
+a23652fc622a27b8863c39f524707796967095b2a85f334561b11422f71445a2  generation_config.json
+78caa8fd29e4bf2fafcec71ba2b48afcb9516b7d1a43ce20cd0c511c620a42a2  pytorch_model-00001-of-00003.bin
+7cef1f81c0f0bf130b331c4c9c26955da3913d62f141117e85fd5882d6cdf0d0  pytorch_model-00002-of-00003.bin
+1059a1efade70d4a1a9f66176631f0dae239c50dd5c89d62deb873b3d4ea49a1  pytorch_model-00003-of-00003.bin
+72e91e29282dae48ea5562fcf4d6ca0d5a9c2a30ebc8d67174a19e192552a20b  pytorch_model.bin.index.json
+f9ffc4aede0845ab65324ce5dccb823dca2427f9a0710981e5bc2398d73d8162  tokenizer.json
+9e556afd44213b6bd1be2b850ebbbd98f5481437a8021afaf58ee7fb1818d347  tokenizer.model
+bd87e244d21d45c358e5d822aeb2efd4e4d60127e43b648ed3efe7823fd35060  tokenizer_config.json
+```
+
+## Prompting
+
+The current model version has been trained on prompts using three different roles, which are denoted by the following tokens: `<|system|>`, `<|user|>` and `<|model|>`.
+
+The `<|system|>` prompt can be used to inject out-of-channel information behind the scenes, while the `<|user|>` prompt should be used to indicate user input. The `<|model|>` token should then be used to indicate that the model should generate a response. These tokens can happen multiple times and be chained up to form a conversation history.
+
+### Prompting example
+
+Here's a concrete example. Let's say you have the following system prompt:
+
+> This is a text adventure game. Describe the scenario to the user and give him three options to pick from on each turn.
+
+And the user has typed in the following message:
+
+> Start!
+
+To perform inference against the model, the prompt should be formatted like this:
+
+```
+<|system|>This is a text adventure game. Describe the scenario to the user and give him three options to pick from on each turn.<|user|>Start!<|model|>
+```
+
+The model might generate something like:
+
+> You are standing in front of an old, abandoned house. The windows are boarded up, and there's no sign of life around it. As you approach, you notice a strange feeling emanating from within. Suddenly, you hear a voice calling out to you... 'Come inside!'
+>
+> - Go inside the house.
+> - Ignore the call and move away.
+> - Run as fast as you can.
+
+It will automatically emit an end-of-text token (`</s>`) when it judges that the response is complete.
+
+Pretend then that the user has replied with `go inside`. The next prompt should then be:
+
+```
+<|system|>This is a text adventure game. Describe the scenario to the user and give him three options to pick from on each turn.<|user|>Start!<|model|>You are standing in front of an old, abandoned house. The windows are boarded up, and there's no sign of life around it. As you approach, you notice a strange feeling emanating from within. Suddenly, you hear a voice calling out to you... 'Come inside!'
+
+- Go inside the house.
+- Ignore the call and move away.
+- Run as fast as you can.<|user|>go inside<|model|>
+```
+
+Which might generate something like:
+
+> You enter the house, and immediately, a wave of unsettling energy washes over you. Your senses seem heightened, but your mind feels foggy. A figure appears before you - a tall man with piercing eyes. He speaks to you in a language you don't understand.
+>
+> - Ask him what he wants.
+> - Attack him.
+> - Run away.
+
+Same process applies. Usually, it is best to do a sliding window over the user and model turns, but keep the system prompt fixed at the start of the context window.
+
+## Limitations and biases
+
+The intended use-case for this model is fictional writing for entertainment purposes. Any other sort of usage is out of scope.
+
+As such, it was **not** fine-tuned to be safe and harmless: the base model _and_ this fine-tune have been trained on data known to contain profanity and texts that are lewd or otherwise offensive. It may produce socially unacceptable or undesirable text, even if the prompt itself does not include anything explicitly offensive. Outputs might often be factually wrong or misleading.

xor_codec.py

@@ -0,0 +1,92 @@
+'''
+Adapted from OpenAssistant's original xor_codec.py:
+https://huggingface.co/OpenAssistant/oasst-sft-6-llama-30b-xor/raw/main/xor_codec.py
+'''
+import os
+import sys
+import shutil
+import gzip
+import numpy
+from pathlib import Path
+
+def xor_uncompressed(dst, src_payload, src_base, block_size=4096):
+    fp_payload = open(src_payload, 'rb')
+    fp_base = open(src_base, 'rb')
+    with open(dst, 'wb') as fp:
+        while True:
+            buf1 = numpy.array(bytearray(fp_payload.read(block_size)), dtype=numpy.uint8)
+            buf2 = numpy.array(bytearray(fp_base.read(block_size)), dtype=numpy.uint8)
+            padding = len(buf1) - len(buf2)
+            if padding > 0: buf2 = numpy.pad(buf2, (0, padding), 'constant', constant_values=(0,))
+            if padding < 0: buf2 = buf2[:len(buf1)]
+            buf = numpy.bitwise_xor(buf1, buf2)
+            fp.write(buf)
+            if len(buf1) < block_size: break
+    fp_payload.close()
+    fp_base.close()
+
+def xor_encode(dst, src_payload, src_base, block_size=4096):
+    fp_payload = open(src_payload, 'rb')
+    fp_base = open(src_base, 'rb')
+    with gzip.open(dst, 'wb') as fp:
+        while True:
+            buf1 = numpy.array(bytearray(fp_payload.read(block_size)), dtype=numpy.uint8)
+            buf2 = numpy.array(bytearray(fp_base.read(block_size)), dtype=numpy.uint8)
+            padding = len(buf1) - len(buf2)
+            if padding > 0: buf2 = numpy.pad(buf2, (0, padding), 'constant', constant_values=(0,))
+            if padding < 0: buf2 = buf2[:len(buf1)]
+            buf = numpy.bitwise_xor(buf1, buf2)
+            fp.write(buf)
+            if len(buf1) < block_size: break
+    fp_payload.close()
+    fp_base.close()
+
+def xor_decode(dst, src_payload, src_base, block_size=4096):
+    fp_payload = gzip.open(src_payload, 'rb')
+    fp_base = open(src_base, 'rb')
+    with open(dst, 'wb') as fp:
+        while True:
+            buf1 = numpy.array(bytearray(fp_payload.read(block_size)), dtype=numpy.uint8)
+            buf2 = numpy.array(bytearray(fp_base.read(block_size)), dtype=numpy.uint8)
+            padding = len(buf1) - len(buf2)
+            if padding > 0: buf2 = numpy.pad(buf2, (0, padding), 'constant', constant_values=(0,))
+            if padding < 0: buf2 = buf2[:len(buf1)]
+            buf = numpy.bitwise_xor(buf1, buf2)
+            fp.write(buf)
+            if len(buf1) < block_size: break
+    fp_payload.close()
+    fp_base.close()
+
+def xor_dir(dst, src_payload, src_base, decode=True, compress=True):
+    if compress:
+        xor = xor_decode if decode else xor_encode
+    else:
+        xor = xor_uncompressed
+    Path(dst).mkdir(parents=True, exist_ok=True)
+    for path in os.listdir(src_payload):
+        # Don't care about uncopyrightable text files, just copy over.
+        if ".json" in path:
+            print("[*] Copying '%s'" % path)
+            shutil.copy(f"{src_payload}/{path}", f"{dst}/{path}")
+            continue
+
+        print("[*] Processing '%s'" % path)
+        try:
+            xor("%s/%s" % (dst, path), "%s/%s" % (src_payload, path), "%s/%s" % (src_base, path))
+        except Exception as e:
+            print("Exception when processing '%s'" % path)
+
+if __name__ == "__main__":
+    if len(sys.argv) < 4:
+        print("Usage: xor.py <DESTINATION> <PAYLOAD SOURCE> <LLAMA SOURCE> [--encode] [--compress]")
+        exit()
+    dst = sys.argv[1]
+    src_payload = sys.argv[2]
+    src_base = sys.argv[3]
+    decode = True
+    compress = False
+    if len(sys.argv) > 4:
+        for arg in sys.argv[4:]:
+            if arg == "--encode": decode = False
+            if arg == "--compress": compress = True
+    xor_dir(dst, src_payload, src_base, decode=decode, compress=compress)

xor_encoded_files/config.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:be2c276865d1b0759257c0934275f05e02ee520657c2d8ebe3f2a2db1562949a
+size 597

xor_encoded_files/generation_config.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a23652fc622a27b8863c39f524707796967095b2a85f334561b11422f71445a2
+size 137

xor_encoded_files/pytorch_model-00001-of-00003.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:07727e130b7e4ec66162920b4e090554e6c58e87d25b433ab8123eb3a55fd5e7
+size 9948726510

xor_encoded_files/pytorch_model-00002-of-00003.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:26b6f7e020c94347280d8952b054275fe2293267f9a0e99e1c2bf4df724d99d9
+size 9904162976

xor_encoded_files/pytorch_model-00003-of-00003.bin

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5d00548d2c28ced08ec7b4123749f20e9ca4af2a821724f9ec47a1c5cf0f66d4
+size 6178982473

xor_encoded_files/pytorch_model.bin.index.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:72e91e29282dae48ea5562fcf4d6ca0d5a9c2a30ebc8d67174a19e192552a20b
+size 33444

xor_encoded_files/tokenizer.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f9ffc4aede0845ab65324ce5dccb823dca2427f9a0710981e5bc2398d73d8162
+size 1842665

xor_encoded_files/tokenizer.model

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:68147850c080987172d24ad27a9ba2c65c71b46e248e8ee0f0c4eda90e2ca558
+size 499723

xor_encoded_files/tokenizer_config.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bd87e244d21d45c358e5d822aeb2efd4e4d60127e43b648ed3efe7823fd35060
+size 727