chatllm.cpp

纯 C++ 本地跑大模型,开箱即聊不装 Python

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 基础设施 🍴 复刻 76 🐛 待处理 11 👀 关注 22
GitHub ↗
GitHub 星标 ★ 938
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行编译部署

项目预览

chatllm.cpp 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类基础设施
开发团队foldl
定价模式🏷️完全免费
价格说明开源免费,需自行编译部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言C++
技术栈/模型llm,llm-inference
GitHub 星标★ 938
上线时间2023-12-02 00:00:00
代码更新2026-10-27
仓库体积10.1 MB
本站数据更新2026-11-03
维护状态较活跃
收录时间2026-09-16
浏览次数2

项目介绍

chatllm.cpp 是一个用纯 C++ 实现的本地大语言模型推理引擎,目标是在个人电脑上直接运行多种开源模型进行实时对话,不依赖 Python 运行时。它把模型加载、量化推理、采样、对话模板和流式输出整合进一个可编译的 C++ 项目,支持 CPU 与 GPU 后端,覆盖 LLaMA、ChatGLM、Qwen、Baichuan 等常见模型家族。相比 Python 方案,它启动快、内存占用可控、部署简单,适合把 LLM 嵌入到桌面应用、嵌入式设备或已有 C++ 工程中。核心能力包括:多模型统一接口、INT4/INT8 量化、KV Cache 复用、流式 token 输出、命令行交互与简单 Web 演示。项目定位偏底层基础设施,强调可移植性和零依赖,便于二次开发和集成。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 938

技术标签

使用教程

难度:高级 约 45 分钟 部署方式:本地编译 5 步

环境要求

  • C++17 编译器与 CMake
  • Python 3.8+(转换脚本)
  • 16GB+ 内存(大模型)

安装与启动步骤

  1. 1克隆并取子模块

    必须带 --recursive,否则第三方依赖缺失无法编译。

    git clone --recursive https://github.com/foldl/chatllm.cpp.git && cd chatllm.cpp
  2. 2装转换依赖

    模型格式转换用 Python 脚本,需要先装依赖。

    pip install -r requirements.txt
  3. 3编译 C++ 主程序

    用 CMake 构建,CPU 版直接编;要 GPU 加速得加对应后端开关。

    cmake -B build && cmake --build build -j
  4. 4转换模型

    -t 指定量化类型,-a 指定模型架构,LoRA 用 -l 挂载。

    python convert.py -i path/to/model -t q8_0 -o quantized.bin --name ModelName
  5. 5开始对话

    main 直接加载 bin 文件;加 -i 进交互模式,配 rlwrap 更好用。

    ./build/bin/main -m quantized.bin --seed 100
    rlwrap ./build/bin/main -m quantized.bin -i

如何确认成功

./build/bin/main 正常加载模型并输出回复,无段错误。

注意事项

  • 模型必须先转成自有 bin 格式,直接喂 HF 权重会加载失败。
  • 支持 1B 到 300B 的模型,但显存/内存需求随规模线性上升。

核心亮点

  • 纯 C++ 实现,无 Python 依赖,编译后单文件即可运行,便于嵌入现有 C++ 工程
  • 支持 CPU 与 GPU 双后端,并覆盖 LLaMA、ChatGLM、Qwen 等多个主流模型家族
  • 内置量化与 KV Cache,显存/内存占用可控,适合消费级硬件实时对话

不足之处

  • 生态与文档相对薄弱,模型适配和参数调优需要一定 C++ 与推理经验
  • 社区规模较小,更新节奏和问题响应速度不如 llama.cpp 等成熟项目

适用场景

  • 在无 Python 环境的 Windows/Linux 桌面或服务器上部署本地聊天助手
  • 将 LLM 推理能力集成进已有 C++ 应用或游戏引擎中
  • 在边缘设备或低配机器上用 CPU 跑量化模型做离线问答

替代项目

llama.cpp、chatglm.cpp

上一篇:SiliconScope

下一篇:aimock

同类项目推荐

ComfyUI-Windows-Portable 开源

解压即用的 ComfyUI 整合包,省去配置烦恼

ComfyUI standalone pack with 40+ custom nodes. | ComfyUI 大号整合包,预装大量自定义节···

★ 624 2026-08-09
LMCache 开源

复用KV缓存,让LLM推理快如闪电

LMCache: Supercharge Your LLM with the Fastest KV Cache Layer

★ 12260 2026-08-09
OpenToys 开源

用 MacBook 和 ESP32 快速造本地 AI 玩具

Make Local AI Toys, Robots, Devices that work with a MacBook and an Arduino ESP32

★ 171 2026-08-09
gpu_poor 开源

选显卡前先算一算:模型显存和速度一键估算

Calculate token/s & GPU memory requirement for any LLM. Supports llama.cpp/ggml/bnb···

★ 1401 2026-08-09
cerul 开源

让 AI 记住视频内容,秒级检索关键画面

Open-source video processing core and CLI. Search and annotate local videos with you···

★ 166 2026-08-09
openai 开源

兼容 OpenAI 调用方式,请求时自动完成链上按次付费

Drop-in OpenAI Typescript client with transparent x402 payment support.

★ 154 2026-10-26
llmfit 开源

一条命令,测出你的硬件能跑哪些 AI 模型

Hundreds of models & providers. One command to find what runs on your hardware.

★ 38563 2026-08-09
openclaw-dashboard 开源

自托管面板,实时看住 AI 智能体的行为与花费

Secure, real-time monitoring dashboard for OpenClaw AI agents. Auth, TOTP MFA, cost ···

★ 698 2026-10-25
ai-observer 开源

把多个 AI 编程助手的调用记录统一收进本地 DuckDB,随时查。

Unified local observability for AI coding assistants

★ 281 2026-09-23