0x00 背景
前不久,Meta前脚发布完开源大语言模型LLaMA,
随后就被网友“泄漏”,直接放了一个磁力链接下载链接。
然而那些手头没有顶级显卡的朋友们,就只能看看而已了
但是 Georgi Gerganov 开源了一个项目llama.cpp
ggerganov/llama.cpp: Port of Facebook’s LLaMA model in C/C++ (github.com)
次项目的牛逼之处就是没有GPU也能跑LLaMA模型
大大降低的使用成本,本文就是时间如何在我的 mac m1 pro 上面跑起来这个模型
llama.cpp:提供了一种模型量化和在本地CPU上部署方式
文本介绍了如何使用llama.cpp工具将深度学习模型进行量化并在本地CPU上部署的详细步骤。
以下是具体步骤的解释:
ç
0x01 Step1 环境准备
- 高版本python 3.10
pip install protobuf==3.20.0
pip install transformers 最新版
pip installsentencepiece (0.1.97测试通过)
pip install peft (0.2.0测试通过)
pip install git+https://github.com/huggingface/transformers
pip install sentencepiece
pip install peft
-
确保机器有足够的内存加载完整模型 ,7B模型需要13-15G
-
下载原版LLaMA模型的权重和tokenizer.model文件
下载参考这个[PR]https://github.com/facebookresearch/llama/pull/73/files
压缩包内文件目录如下(LLaMA-7B为例):
chinese_llama_lora_7b/- adapter_config.json # LoRA权重配置文件- adapter_model.bin # LoRA权重文件- special_tokens_map.json # special_tokens_map文件- tokenizer_config.json # tokenizer配置文件- tokenizer.model # tokenizer文件
Step 2: 将原版LLaMA模型转换为HF格式
请使用transformers提供的脚本convert_llama_weights_to_hf.py
将原版LLaMA模型转换为HuggingFace格式。
将原版LLaMA的tokenizer.model
放在--input_dir
指定的目录,其余文件放在${input_dir}/${model_size}
下。 执行以下命令后,--output_dir
中将存放转换好的HF版权重。
python src/transformers/models/llama/convert_llama_weights_to_hf.py \--input_dir path_to_original_llama_root_dir \--model_size 7B \--output_dir path_to_original_llama_hf_dir
Step 2: 合并LoRA权重,生成全量模型权重
使用ymcui/Chinese-LLaMA-Alpaca at v2.0 (github.com)里面的scripts/merge_llama_with_chinese_lora.py
脚本
对原版LLaMA模型(HF格式)扩充中文词表,并与LoRA权重进行合并,生成全量模型权重consolidated.*.pth
(建议检查生成模型的SHA256值)和配置文件params.json
。请执行以下命令:
此处可有两种选择:
- 输出PyTorch版本权重(
.pth
文件),使用merge_llama_with_chinese_lora.py
脚本- 使用llama.cpp工具进行量化和部署
- 输出HuggingFace版本权重(
.bin
文件),使用merge_llama_with_chinese_lora_to_hf.py
脚本(感谢@sgsdxzy 提供)- 使用Transformers进行推理
- 使用text-generation-webui搭建界面
以上两个脚本所需参数一致,仅输出文件格式不同。下面以生成PyTorch版本权重为例,介绍相应的参数设置。
python scripts/merge_llama_with_chinese_lora.py \--base_model path_to_original_llama_hf_dir \--lora_model path_to_chinese_llama_or_alpaca_lora \--output_dir path_to_output_dir
参数说明:
我这里直接使用了Model Hub上的模型,因为很小就直接下载了使用,懒惰下载到本地
--base_model
:存放HF格式的LLaMA模型权重和配置文件的目录(Step 1生成)--lora_model
:这就是你要合并的 LoRA模型 所在目录,也可使用Model Hub上的模型名:ziqingyang/chinese-alpaca-lora-7b
或ziqingyang/chinese-llama-lora-7b
--output_dir
:指定保存全量模型权重的目录,默认为./
- (可选)
--offload_dir
:对于低内存用户需要指定一个offload缓存路径
Step 3: llama.cpp 本地快速部署
大模型在自己的电脑上进行本地部署(CPU推理)
下载llama.cpp工具https://github.com/ggerganov/llama.cpp
推荐使用MacOS和Linux系统,Windows好像有bug
运行前请确保:
- 模型量化过程需要将未量化模型全部载入内存,请确保有足够可用内存(7B版本需要13G以上)
- 加载使用Q4量化后的模型时(例如7B版本),确保本机可用内存大于4-6G(受上下文长度影响)
- 系统应有
make
(MacOS/Linux自带)或cmake
(Windows需自行安装)编译工具 - 推荐使用Python 3.9或3.10编译运行llama.cpp工具(因为
sentencepiece
还不支持3.11)
1. 下载和编译llama.cpp
运行以下命令对llama.cpp项目进行编译,生成./main
和./quantize
二进制文件。
git clone https://github.com/ggerganov/llama.cpp && cd llama.cpp && make
2.生成量化版本模型
把合并模型(选择生成.pth
格式模型)中最后一步生成的tokenizer.model
文件放入xx-models
目录下,模型文件consolidated.*.pth
和配置文件params.json
放入xx-models/7B
目录下。
请注意LLaMA和Alpaca的tokenizer.model
不可混用
目录结构类似:
- 7B/- consolidated.00.pth- params.json- tokenizer.model
将上述.pth
模型权重转换为ggml的FP16格式,生成文件路径为xx-models/7B/ggml-model-f16.bin
。
python3 ./llama.cpp/convert-pth-to-ggml.py ./xx_model/7B/ 1
进一步对FP16模型进行Q4量化,生成量化模型文件路径为zh-models/7B/ggml-model-q4_0.bin
。
./quantize ./xx-models/7B/ggml-model-f16.bin ./xx-models/7B/ggml-model-q4_0.bin 2
3.加载并启动模型
运行./main
二进制文件,-m
命令指定Q4量化模型(也可加载ggml-FP16的模型)。以下是解码参数示例:
./main -m xx-models/7B/ggml-model-q4_0.bin --color -f prompts/alpaca.txt -ins -c 2048 --temp 0.2 -n 256 --repeat_penalty 1.3
在提示符 >
之后输入你的prompt,command+c
中断输出,多行信息以\
作为行尾。如需查看帮助和参数说明,请执行./main -h
命令。
重要参数说明:
-ins 启动类ChatGPT的对话交流模式
-f 指定prompt模板,alpaca模型请加载prompts/alpaca.txt
-c 控制上下文的长度,值越大越能参考更长的对话历史
-n 控制回复生成的最大长度
--repeat_penalty 控制生成回复中对重复文本的惩罚力度
--temp 温度系数,值越低回复的随机性越小,反之越大
--top_p, top_k 控制采样的相关参数