Repolode
RightNow-AI

RightNow-AI/picolm

一个纯 C 编写的轻量 LLM 推理引擎,可在树莓派等低成本开发板上以约 45MB 内存运行 GGUF 格式的小型模型。

Star
2,210
Fork
286
未关闭 Issue
23
最近提交
8个月前

这是什么?

PicoLM 是一个从零实现的 LLM 推理引擎,用约 2500 行纯 C11 代码编写,没有任何外部依赖。它可以加载 GGUF 格式的 LLaMA 架构模型(如 TinyLlama 1.1B),目标运行环境包括树莓派 Zero 2W、树莓派 3/4/5、RISC-V 开发板,以及 x86-64 的 Linux、Windows 和 macOS 机器。

模型文件以内存映射方式读取,而不是整体载入内存,由操作系统按层调页。在 2048 上下文、FP16 KV 缓存的配置下,运行时内存约 45MB,可执行文件约 80KB。推理支持 Q2_K 至 Q8_0 等量化权重以及 F16、F32,并利用 ARM NEON 和 x86 SSE2 SIMD 指令,矩阵乘法通过 pthread 多线程并行执行。

程序可从标准输入读取提示词。`--json` 模式通过掩码约束输出,保证结果为合法 JSON,适合工具调用;`--cache` 选项可保存提示词状态,重复运行时跳过预填充阶段。PicoLM 设计上可作为 PicoClaw 智能体的本地模型后端,也可作为独立命令行工具使用。

核心功能

  • 01直接读取 GGUF v2/v3 模型文件,无需转换
  • 02支持 Q2_K 至 Q8_0 量化以及 F16、F32 权重
  • 03通过内存映射读取权重,运行时只占用部分模型内存
  • 04提供 `--json` 语法约束模式,输出合法 JSON
  • 05支持 `--cache` 保存 KV 缓存,跳过重复的提示词预填充
  • 06可在 ARM、x86-64 和 RISC-V 上构建,支持 Linux、Windows 和 macOS

适用场景

  • 在树莓派或类似开发板上运行离线小型聊天助手
  • 在低功耗设备上实现带有保证 JSON 输出的本地工具调用
  • 在 RISC-V 或其他嵌入式硬件上研究 LLM 推理
  • 作为 PicoClaw 智能体的本地模型后端

快速上手

  1. 1

    从源码在本机编译

    make native
  2. 2

    下载 TinyLlama 模型(638 MB)

    make model
  3. 3

    运行一次测试生成

    ./picolm /opt/picolm/models/tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf -p "The meaning of life is" -n 100

使用前须知

  • 仅支持 GGUF 格式的 LLaMA 架构模型,例如 TinyLlama 1.1B。
  • 在低成本开发板上生成速度较慢,按 README 约为每秒 1 到 10 个 token。
  • README 中的构建和安装步骤主要面向 Linux、树莓派和 Windows(MSVC)。

标签

常见问题

picolm 是什么?
一个纯 C 编写的轻量 LLM 推理引擎,可在树莓派等低成本开发板上以约 45MB 内存运行 GGUF 格式的小型模型。 PicoLM 是一个从零实现的 LLM 推理引擎,用约 2500 行纯 C11 代码编写,没有任何外部依赖。它可以加载 GGUF 格式的 LLaMA 架构模型(如 TinyLlama 1.1B),目标运行环境包括树莓派 Zero 2W、树莓派 3/4/5、RISC-V 开发板,以及 x86-64 的 Linux、Windows 和 macOS 机器。
picolm 可以免费使用吗?用的什么许可证?
picolm 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
picolm 还在维护吗?
超过半年未提交。picolm 最近一次提交是在 2026年2月22日。
picolm 适合用来做什么?
在树莓派或类似开发板上运行离线小型聊天助手 在低功耗设备上实现带有保证 JSON 输出的本地工具调用 在 RISC-V 或其他嵌入式硬件上研究 LLM 推理 作为 PicoClaw 智能体的本地模型后端
picolm 怎么安装和运行?
从源码在本机编译: make native 下载 TinyLlama 模型(638 MB): make model 运行一次测试生成: ./picolm /opt/picolm/models/tinyllama-1.1b-chat-v1.0.Q4_K_M.gguf -p "The meaning of life is" -n 100
在哪里获取 picolm?
源代码和安装说明在 GitHub 上:https://github.com/RightNow-AI/picolm

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目