
chatllm.cpp
纯 C++ 本地跑大模型,开箱即聊不装 Python
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 938
技术标签
使用教程
环境要求
- C++17 编译器与 CMake
- Python 3.8+(转换脚本)
- 16GB+ 内存(大模型)
安装与启动步骤
-
1克隆并取子模块
必须带 --recursive,否则第三方依赖缺失无法编译。
git clone --recursive https://github.com/foldl/chatllm.cpp.git && cd chatllm.cpp -
2装转换依赖
模型格式转换用 Python 脚本,需要先装依赖。
pip install -r requirements.txt -
3编译 C++ 主程序
用 CMake 构建,CPU 版直接编;要 GPU 加速得加对应后端开关。
cmake -B build && cmake --build build -j -
4转换模型
-t 指定量化类型,-a 指定模型架构,LoRA 用 -l 挂载。
python convert.py -i path/to/model -t q8_0 -o quantized.bin --name ModelName -
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 大号整合包,预装大量自定义节···
LMCache
开源
复用KV缓存,让LLM推理快如闪电
LMCache: Supercharge Your LLM with the Fastest KV Cache Layer
OpenToys
开源
用 MacBook 和 ESP32 快速造本地 AI 玩具
Make Local AI Toys, Robots, Devices that work with a MacBook and an Arduino ESP32
gpu_poor
开源
选显卡前先算一算:模型显存和速度一键估算
Calculate token/s & GPU memory requirement for any LLM. Supports llama.cpp/ggml/bnb···
cerul
开源
让 AI 记住视频内容,秒级检索关键画面
Open-source video processing core and CLI. Search and annotate local videos with you···
openai
开源
兼容 OpenAI 调用方式,请求时自动完成链上按次付费
Drop-in OpenAI Typescript client with transparent x402 payment support.
llmfit
开源
一条命令,测出你的硬件能跑哪些 AI 模型
Hundreds of models & providers. One command to find what runs on your hardware.
openclaw-dashboard
开源
自托管面板,实时看住 AI 智能体的行为与花费
Secure, real-time monitoring dashboard for OpenClaw AI agents. Auth, TOTP MFA, cost ···
ai-observer
开源
把多个 AI 编程助手的调用记录统一收进本地 DuckDB,随时查。
Unified local observability for AI coding assistants