在 CPU 上运行任何量化的 GGUF 模型进行本地推理的教程

在 cpu 上运行任何量化的 gguf 模型进行本地推理的教程

本文档旨在指导读者如何在 CPU 上使用 llama-cpp-python 库运行任何量化的 GGUF 格式的开源 LLM 模型,例如 Llama 3、Mistral 或 Zephyr 等,而无需依赖 ctransformers 库支持。 本教程涵盖了环境配置、模型下载、推理代码编写以及一些实用技巧,帮助读者快速上手并解决常见问题

使用 llama-cpp-python 进行 CPU 推理

llama-cpp-python 是一个流行的 Python 库,它基于 llama.cpp,允许在 CPU 上运行量化的 LLM 模型。它易于使用,并且通常是第一个支持新型号量化版本的库之一。

1. 环境配置

首先,需要安装 llama-cpp-python 和 huggingface_hub。 llama-cpp-python 用于加载和运行模型,而 huggingface_hub 用于从 Hugging Face Model Hub 下载模型。

在终端中运行以下命令:

pip install llama-cpp-pythonpip install huggingface_hub

请注意,上述命令安装的是 CPU 版本的 llama-cpp-python。 如果您想使用 GPU 加速,则需要进行额外的配置,具体步骤不在本文档的讨论范围内。

2. 模型下载

使用 huggingface_hub 从 Hugging Face Model Hub 下载 GGUF 模型。以下代码示例演示了如何下载 Mixtral-8x7B-Instruct-v0.1 模型:

from huggingface_hub import hf_hub_downloadmodel_name = "TheBloke/Mixtral-8x7B-Instruct-v0.1-GGUF"model_file = "mixtral-8x7b-instruct-v0.1.Q4_K_M.gguf"model_path = hf_hub_download(model_name, filename=model_file)print(f"Model downloaded to: {model_path}")

这段代码将下载 mixtral-8x7b-instruct-v0.1.Q4_K_M.gguf 文件到本地。 Q4_K_M 表示 4-bit 量化模型,您可以根据需要选择其他量化级别。

3. 模型加载与推理

下载模型后,可以使用 llama-cpp-python 加载并运行模型。以下代码示例展示了如何加载模型并生成文本:

from llama_cpp import Llamallm = Llama(    model_path=model_path,    n_ctx=16000,  # Context length to use    n_threads=32,  # Number of CPU threads to use    n_gpu_layers=0  # Number of model layers to offload to GPU)generation_kwargs = {    "max_tokens": 20000,    "stop": [""],    "echo": False,  # Echo the prompt in the output    "top_k": 1  # This is essentially greedy decoding, since the model will always return the highest-probability token. Set this value > 1 for sampling decoding}prompt = "The meaning of life is "res = llm(prompt, **generation_kwargs)print(res["choices"][0]["text"])

这段代码首先使用 Llama 类加载模型,并设置上下文长度 (n_ctx)、线程数 (n_threads) 和 GPU 层数 (n_gpu_layers)。 由于我们要在 CPU 上运行模型,因此将 n_gpu_layers 设置为 0。

然后,定义生成参数 generation_kwargs,例如最大 token 数 (max_tokens)、停止词 (stop)、是否回显提示 (echo) 和 top-k 值 (top_k)。

最后,使用 llm 对象运行推理,并将结果打印到控制台。

4. 模型选择

Mixtral-8x7B 是一个相对较大的模型,可能需要大量的内存才能运行。 如果您的计算机内存有限,可以尝试使用较小的模型,例如 Llama-2-13B 或 Mistral-7B。

以下是一些较小模型的示例:

model_name=”TheBloke/Llama-2-13B-chat-GGUF”; model_file=”llama-2-13b-chat.Q4_K_M.gguf”model_name=”TheBloke/Mistral-7B-OpenOrca-GGUF”; model_file=”mistral-7b-openorca.Q4_K_M.gguf”

注意事项

确保您的计算机具有足够的内存来运行模型。根据您的 CPU 核心数调整 n_threads 参数。您可以尝试不同的量化级别,以在性能和内存使用之间找到平衡。top_k=1 实际上是贪婪解码,模型总是返回最高概率的 token。 为了获得更多样化的输出,请将此值设置为大于 1 的值,以启用采样解码。

总结

本教程介绍了如何使用 llama-cpp-python 在 CPU 上运行量化的 GGUF 模型。 通过遵循这些步骤,您可以轻松地在本地运行各种开源 LLM 模型,并探索它们的强大功能。请记住,选择合适的模型和调整参数对于获得最佳性能至关重要。

以上就是在 CPU 上运行任何量化的 GGUF 模型进行本地推理的教程的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1374984.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 14:37:04
下一篇 2025年12月14日 14:37:23

相关推荐

  • 如何解决本地图片在使用 mask JS 库时出现的跨域错误?

    如何跨越localhost使用本地图片? 问题: 在本地使用mask js库时,引入本地图片会报跨域错误。 解决方案: 要解决此问题,需要使用本地服务器启动文件,以http或https协议访问图片,而不是使用file://协议。例如: python -m http.server 8000 然后,可以…

    2025年12月24日
    200
  • 使用 Mask 导入本地图片时,如何解决跨域问题?

    跨域疑难:如何解决 mask 引入本地图片产生的跨域问题? 在使用 mask 导入本地图片时,你可能会遇到令人沮丧的跨域错误。为什么会出现跨域问题呢?让我们深入了解一下: mask 框架假设你以 http(s) 协议加载你的 html 文件,而当使用 file:// 协议打开本地文件时,就会产生跨域…

    2025年12月24日
    200
  • 正则表达式在文本验证中的常见问题有哪些?

    正则表达式助力文本输入验证 在文本输入框的验证中,经常遇到需要限定输入内容的情况。例如,输入框只能输入整数,第一位可以为负号。对于不会使用正则表达式的人来说,这可能是个难题。下面我们将提供三种正则表达式,分别满足不同的验证要求。 1. 可选负号,任意数量数字 如果输入框中允许第一位为负号,后面可输入…

    2025年12月24日
    000
  • 为什么多年的经验让我选择全栈而不是平均栈

    在全栈和平均栈开发方面工作了 6 年多,我可以告诉您,虽然这两种方法都是流行且有效的方法,但它们满足不同的需求,并且有自己的优点和缺点。这两个堆栈都可以帮助您创建 Web 应用程序,但它们的实现方式却截然不同。如果您在两者之间难以选择,我希望我在两者之间的经验能给您一些有用的见解。 在这篇文章中,我…

    2025年12月24日
    000
  • 姜戈顺风

    本教程演示如何在新项目中从头开始配置 django 和 tailwindcss。 django 设置 创建一个名为 .venv 的新虚拟环境。 # windows$ python -m venv .venv$ .venvscriptsactivate.ps1(.venv) $# macos/linu…

    2025年12月24日
    000
  • 花 $o 学习这些编程语言或免费

    → Python → JavaScript → Java → C# → 红宝石 → 斯威夫特 → 科特林 → C++ → PHP → 出发 → R → 打字稿 []https://x.com/e_opore/status/1811567830594388315?t=_j4nncuiy2wfbm7ic…

    2025年12月24日
    000
  • 揭示绝对定位的缺点并提出解决方案:常见问题的规避策略

    绝对定位的弊端揭秘:如何避免常见问题? 绝对定位是网页设计中常用的一种布局方式,它可以让元素精确地定位在页面上的指定位置。然而,尽管绝对定位在某些情况下非常有用,但它也存在一些弊端。本文将揭示绝对定位的弊端,并提供一些方法来避免常见问题。 首先,绝对定位的一个弊端是元素定位可能受到浏览器窗口大小的影…

    2025年12月24日
    000
  • 常见问题和解决方法:绝对定位运动指令的疑问与解答

    绝对定位运动指令的常见问题及解决方法 摘要:随着技术的不断进步,绝对定位运动在现代机械设备中得到了广泛应用。然而,在使用绝对定位运动指令的过程中,常常会遇到各种问题。本文将重点讨论常见的绝对定位运动指令问题,并提供相应的解决方法和具体的代码示例。 一、绝对定位运动指令简介绝对定位运动指令是指根据目标…

    2025年12月24日
    000
  • 揭秘绝对定位故障:常见问题和解决方法曝光

    绝对定位故障大揭秘:常见问题及解决方案 引言: 绝对定位(Absolute positioning)是CSS中常用的一种定位方式,它允许开发者将元素精确地放置在一个给定的位置上。然而,由于其特殊的性质和较为复杂的用法,绝对定位经常会出现各种问题。本文将揭示绝对定位的常见故障,并提供相应的解决方案,同…

    2025年12月24日
    000
  • 详解Css Flex 弹性布局中的常见问题及解决方案

    详解CSS Flex弹性布局中的常见问题及解决方案 引言:CSS Flex弹性布局是一种现代的布局方式,其具有优雅简洁的语法和强大的灵活性,广泛应用于构建响应式的web页面。然而,在实际应用中,经常会遇到一些常见的问题,如元素排列不如预期、尺寸不一致等。本文将详细介绍这些问题,并提供相应的解决方案,…

    2025年12月24日
    200
  • CSS的选择器有哪些常见问题

    这次给大家带来css的选择器有哪些常见问题,处理css的选择器常见问题的注意事项有哪些,下面就是实战案例,一起来看一下。 选择器常见的有哪几种?1.标签选择器p{ }/选择标签名为p的元素/2.类选择器.box{ }/选择class名为box的元素/3.ID选择器#header{ }/选择id名为h…

    好文分享 2025年12月24日
    000
  • HTML里的常见问题一

    这次给大家带来在html里有哪些经常出现的问题?有序列表、无序列表、自定义列表如何使用?写个简单的例子。三者在语义上有什么区别?使用场景是什么? 能否嵌套? 有序列表是以数字进行标记的列表项目: CoffeeMilk 效果如下: CoffeeMilk 无序列表是以原点标记的列表项目: CoffeeM…

    好文分享 2025年12月24日
    000
  • HTML里的常见问题二

    如何去查css熟悉的兼容性?比如inline-block哪些浏览器支持?a 标签的href, title, target 是什么? title 和 alt有什么区别?如何新窗口打开链接?display: none和visibility: hidden有什么作用?有什么区别? line-height有…

    好文分享 2025年12月24日
    000
  • html5怎么导视频_html5用video标签导出或Canvas转DataURL获视频【导出】

    HTML5无法直接导出video标签内容,需借助Canvas捕获帧并结合MediaRecorder API、FFmpeg.wasm或服务端协同实现。MediaRecorder适用于WebM格式前端录制;FFmpeg.wasm支持MP4等格式及精细编码控制;服务端方案适合高负载场景。 如果您希望在网页…

    2025年12月23日
    300
  • 如何查看编写的html_查看自己编写的HTML文件效果【效果】

    要查看HTML文件的浏览器渲染效果,需确保文件以.html为扩展名保存、用浏览器直接打开、利用开发者工具调试、必要时启用本地HTTP服务器、或使用编辑器实时预览插件。 如果您编写了HTML代码,但无法直观看到其在浏览器中的实际渲染效果,则可能是由于文件未正确保存、未使用浏览器打开或文件扩展名设置错误…

    2025年12月23日
    400
  • node.js怎么运行html_node.js运行html步骤【指南】

    答案是使用Node.js内置http模块、Express框架或第三方工具serve可快速搭建服务器预览HTML文件。首先通过http模块创建服务器并读取index.html返回响应;其次用Express初始化项目并配置静态文件服务;最后利用serve工具全局安装后一键启动服务器,三种方式均在浏览器访…

    2025年12月23日
    300
  • html5怎么打包运行_HT5用Webpack或Gulp打包后浏览器打开运行【打包】

    应通过 HTTP 服务运行打包后的 HTML5 页面,而非双击打开:一、Webpack 配 webpack-dev-server 启动本地服务;二、Gulp 配 BrowserSync 提供实时重载;三、用 Python/Node.js 轻量 HTTP 工具托管 dist 目录;四、仅当必须双击运行…

    2025年12月23日
    000
  • html5文件运行不出来怎么回事_析html5文件运行失败原因【解析】

    首先检查文件扩展名和编码格式,确保为.html且使用UTF-8编码;接着验证HTML5结构完整性,包含及正确闭合的标签;然后排查外部资源路径是否正确,利用开发者工具查看404错误;排除浏览器兼容性问题,优先在现代浏览器中测试并避免未广泛支持的API;检查JavaScript语法错误与执行顺序,确保脚…

    2025年12月23日
    000
  • html5怎么插入文档_HT5用object或iframe嵌入PDF/Word文档显示【插入】

    可在HTML5中用iframe或object标签嵌入PDF,需设宽高及可访问路径;Word文档需借OneDrive等第三方服务代理渲染;须处理跨域限制并提供下载降级方案。 如果您希望在HTML5页面中嵌入PDF或Word文档并直接显示,可以使用或标签实现。以下是几种可行的嵌入方法: 一、使用ifra…

    2025年12月23日
    200
  • 如何运行html代码_html代码运行方法【步骤】

    HTML代码需保存为.html文件并用浏览器打开才能正确显示;若含AJAX或外部资源则需本地服务器;临时测试可用开发者工具;在线编辑器支持即时预览。 如果您编写了一段HTML代码,但无法在浏览器中正确显示效果,则可能是由于文件未以正确的格式保存或未通过浏览器打开。以下是运行HTML代码的具体步骤: …

    2025年12月23日
    000

发表回复

登录后才能评论
关注微信