uploaded readme

README.md

@@ -0,0 +1,302 @@
+Quantization made by Richard Erkhov.
+
+[Github](https://github.com/RichardErkhov)
+
+[Discord](https://discord.gg/pvy7H8DZMG)
+
+[Request more models](https://github.com/RichardErkhov/quant_request)
+
+
+Meta-Llama-3-8B-Instruct-zh-10k - GGUF
+- Model creator: https://huggingface.co/XavierSpycy/
+- Original model: https://huggingface.co/XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k/
+
+
+| Name | Quant method | Size |
+| ---- | ---- | ---- |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q2_K.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q2_K.gguf) | Q2_K | 2.96GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.IQ3_XS.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.IQ3_XS.gguf) | IQ3_XS | 3.28GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.IQ3_S.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.IQ3_S.gguf) | IQ3_S | 3.43GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_S.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_S.gguf) | Q3_K_S | 3.41GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.IQ3_M.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.IQ3_M.gguf) | IQ3_M | 3.52GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q3_K.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q3_K.gguf) | Q3_K | 3.74GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_M.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_M.gguf) | Q3_K_M | 3.74GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_L.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q3_K_L.gguf) | Q3_K_L | 4.03GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.IQ4_XS.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.IQ4_XS.gguf) | IQ4_XS | 4.18GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q4_0.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q4_0.gguf) | Q4_0 | 4.34GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.IQ4_NL.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.IQ4_NL.gguf) | IQ4_NL | 4.38GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q4_K_S.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q4_K_S.gguf) | Q4_K_S | 4.37GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q4_K.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q4_K.gguf) | Q4_K | 4.58GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q4_K_M.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q4_K_M.gguf) | Q4_K_M | 4.58GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q4_1.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q4_1.gguf) | Q4_1 | 4.78GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q5_0.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q5_0.gguf) | Q5_0 | 5.21GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q5_K_S.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q5_K_S.gguf) | Q5_K_S | 5.21GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q5_K.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q5_K.gguf) | Q5_K | 5.34GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q5_K_M.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q5_K_M.gguf) | Q5_K_M | 5.34GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q5_1.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q5_1.gguf) | Q5_1 | 5.65GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q6_K.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q6_K.gguf) | Q6_K | 6.14GB |
+| [Meta-Llama-3-8B-Instruct-zh-10k.Q8_0.gguf](https://huggingface.co/RichardErkhov/XavierSpycy_-_Meta-Llama-3-8B-Instruct-zh-10k-gguf/blob/main/Meta-Llama-3-8B-Instruct-zh-10k.Q8_0.gguf) | Q8_0 | 7.95GB |
+
+
+
+
+Original model description:
+---
+license: apache-2.0
+language:
+- en
+- zh
+base_model: meta-llama/Meta-Llama-3-8B-Instruct
+tags: 
+- text-generation
+- transformers
+- lora
+- llama.cpp
+- autoawq
+- auto-gptq
+datasets:
+- llamafactory/alpaca_zh
+- llamafactory/alpaca_gpt4_zh
+---
+
+# Meta-Llama-3-8B-Instruct-zh-10k: A Llama🦙 which speaks Chinese / 一只说中文的羊驼🦙
+
+## Model Details / 模型细节
+This model, <u>`Meta-Llama-3-8B-Instruct-zh-10k`</u>, was fine-tuned from the original [Meta-Llama-3-8B-Instruct](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct) due to its underperformance in Chinese. Utilizing the LoRa technology within the [LLaMA-Factory](https://github.com/hiyouga/LLaMA-Factory) utilities, this model was adapted to better handle Chinese through three epochs on three corpora: `alpaca_zh`, `alpaca_gpt4_zh`, and `oaast_sft_zh`, amounting to approximately 10,000 examples. This is reflected in the `10k` in its name.
+
+由于原模型[Meta-Llama-3-8B-Instruct](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct)在中文上表现欠佳，于是该模型 <u>`Meta-Llama-3-8B-Instruct-zh-10k`</u> 微调自此。在[LLaMA-Factory](https://github.com/hiyouga/LLaMA-Factory)工具下，利用LoRa 技术，通过`alpaca_zh`、`alpaca_gpt4_zh`和`oaast_sft_zh`三个语料库上、经过三个训练轮次，我们将该模型调整得更好地掌握了中文。三个语料库共计约10,000个样本，这也是其名字中的 `10k` 的由来。
+
+For efficient inference, the model was converted to the gguf format using [llama.cpp](https://github.com/ggerganov/llama.cpp) and underwent quantization, resulting in a compact model size of about 3.18 GB, suitable for distribution across various devices.
+
+为了高效的推理，使用 [llama.cpp](https://github.com/ggerganov/llama.cpp)，我们将该模型转化为了gguf格式并量化，从而得到了一个压缩到约 3.18 GB 大小的模型，适合分发在各类设备上。
+
+### LoRa Hardware / LoRa 硬件
+- RTX 4090D x 1
+
+> [!NOTE]
+> The complete fine-tuning process took approximately 12 hours. / 完整微调过程花费约12小时。
+
+Additional fine-tuning configurations are avaiable at [Hands-On LoRa](https://github.com/XavierSpycy/hands-on-lora) or [Llama3Ops](https://github.com/XavierSpycy/llama-ops).
+
+更多微调配置可以在我的个人仓库 [Hands-On LoRa](https://github.com/XavierSpycy/hands-on-lora) 或 [Llama3Ops](https://github.com/XavierSpycy/llama-ops) 获得。
+
+### Other Models / 其他模型
+- <u>llama.cpp</u>
+    - [Meta-Llama-3-8B-Instruct-zh-10k-GGUF](https://huggingface.co/XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-GGUF)
+
+- <u>AutoAWQ</u>
+    - [Meta-Llama-3-8B-Instruct-zh-10k-AWQ](https://huggingface.co/XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-AWQ)
+
+- <u>AutoGPTQ</u>
+    - [Meta-Llama-3-8B-Instruct-zh-10k-GPTQ](https://huggingface.co/XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-GPTQ)
+
+### Model Developer / 模型开发者
+- **Pretraining**: Meta
+- **Fine-tuning**: [XavierSpycy @ GitHub ](https://github.com/XavierSpycy) | [XavierSpycy @ 🤗](https://huggingface.co/XavierSpycy)
+
+- **预训练**: Meta
+- **微调**: [XavierSpycy @ GitHub](https://github.com/XavierSpycy) | [XavierSpycy @ 🤗 ](https://huggingface.co/XavierSpycy)
+
+
+### Usage / 用法
+This model can be utilized like the original <u>Meta-Llama3</u> but offers enhanced performance in Chinese.
+
+我们能够像原版的<u>Meta-Llama3</u>一样使用该模型，而它提供了提升后的中文能力。
+
+#### 1. How to use in transformers
+```python
+# !pip install accelerate
+
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM
+
+model_id = "XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k"
+
+model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype=torch.bfloat16, device_map="auto")
+tokenizer = AutoTokenizer.from_pretrained(model_id)
+
+prompt = "你好，你是谁？"
+
+messages = [
+    {"role": "system", "content": "你是一个乐于助人的助手。"},
+    {"role": "user", "content": prompt}]
+
+input_ids = tokenizer.apply_chat_template(
+    messages, add_generation_prompt=True, return_tensors="pt").to(model.device)
+
+terminators = [tokenizer.eos_token_id, tokenizer.convert_tokens_to_ids("<|eot_id|>")]
+
+outputs = model.generate(
+    input_ids,
+    max_new_tokens=256,
+    eos_token_id=terminators,
+    do_sample=True,
+    temperature=0.6,
+    top_p=0.9)
+
+response = outputs[0][input_ids.shape[-1]:]
+
+print(tokenizer.decode(response, skip_special_tokens=True))
+# 我是一个人工智能助手，旨在帮助用户解决问题和完成任务。
+# 我是一个虚拟的人工智能助手，能够通过自然语言处理技术理解用户的需求并为用户提供帮助。
+```
+
+#### 2. How to use in llama.cpp / 如何在llama.cpp中使用
+
+
+```python
+# CMAKE_ARGS="-DLLAMA_BLAS=ON -DLLAMA_BLAS_VENDOR=OpenBLAS # -DLLAMA_CUDA=on" \
+#  pip install llama-cpp-python \
+#  --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu121
+
+# Please download the model weights first. / 请先下载模型���重。
+
+from llama_cpp import Llama
+
+llm = Llama(
+      model_path="/path/to/your/model/Meta-Llama-3-8B-Instruct-zh-10k-GGUF/meta-llama-3-8b-instruct-zh-10k.Q8_0.gguf",
+      n_gpu_layers=-1)
+
+# Alternatively / 或者
+# llm = Llama.from_pretrained(
+#     repo_id="XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-GGUF",
+#     filename="*Q8_0.gguf",
+#     verbose=False
+# )
+
+output = llm(
+      "Q: 你好，你是谁？A:", # Prompt
+      max_tokens=256, # Generate up to 32 tokens, set to None to generate up to the end of the context window
+      stop=["Q:", "\n"], # Stop generating just before the model would generate a new question
+      echo=True # Echo the prompt back in the output
+) # Generate a completion, can also call create_completion
+
+print(output['choices'][0]['text'].split("A:")[1].strip())
+
+# 我是一个人工智能聊天机器人，我的名字叫做“智慧助手”，我由一群程序员设计和开发的。我的主要任务就是通过与您交流来帮助您解决问题，为您提供相关的建议和支持。
+```
+
+#### 3. How to use with AutoAWQ / 如何与AutoAWQ一起使用
+```python
+# !pip install autoawq
+
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM
+
+model_id = "XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-AWQ"
+
+model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype=torch.float16, device_map="auto")
+tokenizer = AutoTokenizer.from_pretrained(model_id)
+
+prompt = "你好，你是谁？"
+
+messages = [
+    {"role": "system", "content": "你是一个乐于助人的助手。"},
+    {"role": "user", "content": prompt}]
+
+input_ids = tokenizer.apply_chat_template(
+    messages, add_generation_prompt=True, return_tensors="pt").to(model.device)
+
+terminators = [tokenizer.eos_token_id, tokenizer.convert_tokens_to_ids("<|eot_id|>")]
+
+outputs = model.generate(
+    input_ids,
+    max_new_tokens=256,
+    eos_token_id=terminators,
+    do_sample=True,
+    temperature=0.6,
+    top_p=0.9)
+
+response = outputs[0][input_ids.shape[-1]:]
+
+print(tokenizer.decode(response, skip_special_tokens=True))
+# 你好！我是一个人工智能助手，我的目的是帮助人们解决问题，回答问题，提供信息和建议。
+```
+
+#### 4. How to use with AutoGPTQ / 如何与AutoGPTQ一起使用
+```python
+# !pip install auto-gptq --no-build-isolation
+
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM
+
+model_id = "XavierSpycy/Meta-Llama-3-8B-Instruct-zh-10k-GPTQ"
+
+model = AutoModelForCausalLM.from_pretrained(model_id, torch_dtype=torch.float16, device_map="auto")
+tokenizer = AutoTokenizer.from_pretrained(model_id)
+
+prompt = "什么是机器学习？"
+
+messages = [
+    {"role": "system", "content": "你是一个乐于助人的助手。"},
+    {"role": "user", "content": prompt}]
+
+input_ids = tokenizer.apply_chat_template(
+    messages, add_generation_prompt=True, return_tensors="pt").to(model.device)
+
+terminators = [tokenizer.eos_token_id, tokenizer.convert_tokens_to_ids("<|eot_id|>")]
+
+outputs = model.generate(
+    input_ids,
+    max_new_tokens=256,
+    eos_token_id=terminators,
+    do_sample=True,
+    temperature=0.6,
+    top_p=0.9)
+
+response = outputs[0][input_ids.shape[-1]:]
+
+print(tokenizer.decode(response, skip_special_tokens=True))
+# 机器学习是人工智能（AI）的一个分支，它允许计算机从数据中学习并改善其性能。它是一种基于算法的方法，用于从数据中识别模式并进行预测。机器学习算法可以从数据中学习，例如文本、图像和音频，并从中获得知识和见解。
+```
+
+Further details about the deployment are available in the GitHub repository [Llama3Ops: From LoRa to Deployment with Llama3](https://github.com/XavierSpycy/llama-ops).
+
+更多关于部署的细节可以在我的个人仓库 [Llama3Ops: From LoRa to Deployment with Llama3](https://github.com/XavierSpycy/llama-ops) 获得。
+
+## Ethical Considerations, Safety & Risks / 伦理考量、安全性和风险
+Please refer to [Meta Llama 3's Ethical Considerations](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct#ethical-considerations-and-limitations) for more information. Key points include bias monitoring, responsible usage guidelines, and transparency in model limitations.
+
+请参考 [Meta Llama 3's Ethical Considerations](https://huggingface.co/meta-llama/Meta-Llama-3-8B-Instruct#ethical-considerations-and-limitations)，以获取更多细节。关键点包括偏见监控、负责任的使用指南和模型限制的透明度。
+
+## Limitations / 局限性
+- The comprehensive abilities of the model have not been fully tested. 
+
+- While it performs smoothly in Chinese conversations, further benchmarks are required to evaluate its full capabilities. The quality and quantity of the Chinese corpora used may also limit model outputs. 
+
+- Based on current observations, it fundamentally meets the standards in common sense, logic, sentiment analysis, safety, writing, code, and function calls. However, there is room for improvement in role-playing, mathematics, and handling complex tasks with the same text but different meanings.
+
+- Additionally, catastrophic forgetting in the fine-tuned model has not been evaluated.
+
+- 该模型的全面的能力尚未全部测试。
+
+- 尽管它在中文对话中表现流畅，但需要更多的测评以评估其完整的能力。中文语料库的质量和数量可能都会对模型输出有所制约。
+
+- 根据目前的观察，它在常识、逻辑、情绪分析、安全性、写作、代码和函数调用上基本达标，然而，在角色扮演、数学、复杂的同文异义等任务上有待提高。
+
+- 另外，微调模型中的灾难性遗忘尚未评估。
+
+## Acknowledgements / 致谢
+We thank Meta for their open-source contributions, which have greatly benefited the developer community, and acknowledge the collaborative efforts of developers in enhancing this community. 
+
+我们感谢 Meta 的开源贡献，这极大地帮助了开发者社区，同时，也感谢致力于提升社区的开发者们的努力。
+
+## References / 参考资料
+
+```
+@article{llama3modelcard,
+title={Llama 3 Model Card},
+author={AI@Meta},
+year={2024},
+url = {https://github.com/meta-llama/llama3/blob/main/MODEL_CARD.md}}
+
+@inproceedings{zheng2024llamafactory,
+  title={LlamaFactory: Unified Efficient Fine-Tuning of 100+ Language Models},
+  author={Yaowei Zheng and Richong Zhang and Junhao Zhang and Yanhan Ye and Zheyan Luo and Zhangchi Feng and Yongqiang Ma},
+  booktitle={Proceedings of the 62nd Annual Meeting of the Association for Computational Linguistics (Volume 3: System Demonstrations)},
+  address={Bangkok, Thailand},
+  publisher={Association for Computational Linguistics},
+  year={2024},
+  url={http://arxiv.org/abs/2403.13372}}
+```
+