Upload README.md

README.md

@@ -11,10 +11,34 @@ license: apache-2.0
 model_creator: Mistral AI_
 model_name: Mixtral 8X7B Instruct v0.1
 model_type: mixtral
-prompt_template: '<s>[INST] {prompt} [/INST]
+prompt_template: '[INST] {prompt} [/INST]
 
   '
 quantized_by: TheBloke
+widget:
+- output:
+    text: 'Arr, shiver me timbers! Ye have a llama on yer lawn, ye say? Well, that
+      be a new one for me! Here''s what I''d suggest, arr:
+
+
+      1. Firstly, ensure yer safety. Llamas may look gentle, but they can be protective
+      if they feel threatened.
+
+      2. Try to make the area less appealing to the llama. Remove any food sources
+      or water that might be attracting it.
+
+      3. Contact local animal control or a wildlife rescue organization. They be the
+      experts and can provide humane ways to remove the llama from yer property.
+
+      4. If ye have any experience with animals, you could try to gently herd the
+      llama towards a nearby field or open space. But be careful, arr!
+
+
+      Remember, arr, it be important to treat the llama with respect and care. It
+      be a creature just trying to survive, like the rest of us.'
+  text: '[INST] You are a pirate chatbot who always responds with Arr and pirate speak!
+
+    There''s a llama on my lawn, how can I get rid of him? [/INST]'
 ---
 <!-- markdownlint-disable MD041 -->
 
@@ -44,6 +68,11 @@ quantized_by: TheBloke
 
 This repo contains GPTQ model files for [Mistral AI_'s Mixtral 8X7B Instruct v0.1](https://huggingface.co/mistralai/Mixtral-8x7B-Instruct-v0.1).
 
+Mixtral GPTQs currently require:
+* Transformers 4.36.0 or later
+* either, AutoGPTQ 0.6 compiled from source, or
+* Transformers 4.37.0.dev0 compiled from Github with: `pip3 install git+https://github.com/huggingface/transformers`
+
 Multiple GPTQ parameter permutations are provided; see Provided Files below for details of the options provided, their parameters, and the software used to create them.
 
 <!-- description end -->
@@ -60,7 +89,7 @@ Multiple GPTQ parameter permutations are provided; see Provided Files below for
 ## Prompt template: Mistral
 
 ```
-<s>[INST] {prompt} [/INST]
+[INST] {prompt} [/INST]
 
 ```
 
@@ -73,14 +102,8 @@ Multiple GPTQ parameter permutations are provided; see Provided Files below for
 
 GPTQ models are currently supported on Linux (NVidia/AMD) and Windows (NVidia only). macOS users: please use GGUF models.
 
-These GPTQ models are known to work in the following inference servers/webuis.
-
-- [text-generation-webui](https://github.com/oobabooga/text-generation-webui)
-- [KoboldAI United](https://github.com/henk717/koboldai)
-- [LoLLMS Web UI](https://github.com/ParisNeo/lollms-webui)
-- [Hugging Face Text Generation Inference (TGI)](https://github.com/huggingface/text-generation-inference)
+Mixtral GPTQs currently have special requirements - see Description above.
 
-This may not be a complete list; if you know of others, please let me know!
 <!-- README_GPTQ.md-compatible clients end -->
 
 <!-- README_GPTQ.md-provided-files start -->
@@ -187,6 +210,12 @@ Note that using Git with HF repos is strongly discouraged. It will be much slowe
 <!-- README_GPTQ.md-text-generation-webui start -->
 ## How to easily download and use this model in [text-generation-webui](https://github.com/oobabooga/text-generation-webui)
 
+**NOTE**: Requires:
+
+* Transformers 4.36.0, or Transformers 4.37.0.dev0 from Github
+* Either AutoGPTQ 0.6 compiled from source and `Loader: AutoGPTQ`,
+* or, `Loader: Transformers`, if you installed Transformers from Github: `pip3 install git+https://github.com/huggingface/transformers`
+
 Please make sure you're using the latest version of [text-generation-webui](https://github.com/oobabooga/text-generation-webui).
 
 It is strongly recommended to use the text-generation-webui one-click-installers unless you're sure you know how to make a manual install.
@@ -213,50 +242,18 @@ It is strongly recommended to use the text-generation-webui one-click-installers
 <!-- README_GPTQ.md-use-from-tgi start -->
 ## Serving this model from Text Generation Inference (TGI)
 
-It's recommended to use TGI version 1.1.0 or later. The official Docker container is: `ghcr.io/huggingface/text-generation-inference:1.1.0`
+Not currently supported for Mixtral models.
 
-Example Docker parameters:
-
-```shell
---model-id TheBloke/Mixtral-8x7B-Instruct-v0.1-GPTQ --port 3000 --quantize gptq --max-input-length 3696 --max-total-tokens 4096 --max-batch-prefill-tokens 4096
-```
-
-Example Python code for interfacing with TGI (requires huggingface-hub 0.17.0 or later):
-
-```shell
-pip3 install huggingface-hub
-```
-
-```python
-from huggingface_hub import InferenceClient
-
-endpoint_url = "https://your-endpoint-url-here"
-
-prompt = "Tell me about AI"
-prompt_template=f'''<s>[INST] {prompt} [/INST]
-'''
-
-client = InferenceClient(endpoint_url)
-response = client.text_generation(prompt,
-                                  max_new_tokens=128,
-                                  do_sample=True,
-                                  temperature=0.7,
-                                  top_p=0.95,
-                                  top_k=40,
-                                  repetition_penalty=1.1)
-
-print(f"Model output: {response}")
-```
 <!-- README_GPTQ.md-use-from-tgi end -->
 <!-- README_GPTQ.md-use-from-python start -->
 ## Python code example: inference from this GPTQ model
 
 ### Install the necessary packages
 
-Requires: Transformers 4.33.0 or later, Optimum 1.12.0 or later, and AutoGPTQ 0.4.2 or later.
+Requires: Transformers 4.37.0.dev0 from Github, Optimum 1.16.0 or later, and AutoGPTQ 0.5.1 or later.
 
 ```shell
-pip3 install --upgrade transformers optimum
+pip3 install --upgrade "git+https://github.com/huggingface/transformers" optimum
 # If using PyTorch 2.1 + CUDA 12.x:
 pip3 install --upgrade auto-gptq
 # or, if using PyTorch 2.1 + CUDA 11.x:
@@ -269,8 +266,7 @@ If you are using PyTorch 2.0, you will need to install AutoGPTQ from source. Lik
 pip3 uninstall -y auto-gptq
 git clone https://github.com/PanQiWei/AutoGPTQ
 cd AutoGPTQ
-git checkout v0.5.1
-pip3 install .
+DISABLE_QIGEN=1 pip3 install .
 ```
 
 ### Example Python code
@@ -288,8 +284,9 @@ model = AutoModelForCausalLM.from_pretrained(model_name_or_path,
 
 tokenizer = AutoTokenizer.from_pretrained(model_name_or_path, use_fast=True)
 
-prompt = "Tell me about AI"
-prompt_template=f'''<s>[INST] {prompt} [/INST]
+prompt = "Write a story about llamas"
+system_message = "You are a story writing assistant"
+prompt_template=f'''[INST] {prompt} [/INST]
 '''
 
 print("\n\n*** Generate:")
@@ -320,11 +317,8 @@ print(pipe(prompt_template)[0]['generated_text'])
 <!-- README_GPTQ.md-compatibility start -->
 ## Compatibility
 
-The files provided are tested to work with Transformers. For non-Mistral models, AutoGPTQ can also be used directly.
-
-[ExLlama](https://github.com/turboderp/exllama) is compatible with Llama and Mistral models in 4-bit. Please see the Provided Files table above for per-file compatibility.
+The files provided are tested to work with AutoGPTQ 0.6 (compiled from source) and Transformers 4.37.0 (installed from Github).
 
-For a list of clients/servers, please see "Known compatible clients / servers", above.
 <!-- README_GPTQ.md-compatibility end -->
 
 <!-- footer start -->