
bitsandbytes
把大模型塞进小显存,量化微调一条龙
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 8536
使用教程
⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Python 环境(bitsandbytes 通过 PyPI 分发,支持版本以 PyPI 页面标注为准)
- 已安装 PyTorch(README 明确该库为 PyTorch 提供 k-bit 量化支持)
- 网络可访问 PyPI 以完成安装包下载
安装与启动步骤
-
1检查 Python 环境
确认本机已安装 Python 且可正常调用 pip,版本需满足 PyPI 页面标注的要求。
python --version pip --version -
2确认 PyTorch 就绪
bitsandbytes 依赖 PyTorch 运行,先确认 torch 可导入并查看版本,避免后续量化调用失败。
python -c "import torch; print(torch.__version__)" -
3安装 bitsandbytes
从 PyPI 安装官方发行包,建议在虚拟环境中执行,避免污染系统 Python 环境。
pip install bitsandbytes -
4验证导入是否成功
导入库并打印对象信息,无报错即说明安装路径与依赖正常。
python -c "import bitsandbytes as bnb; print(bnb)"
如何确认成功
执行 python -c "import bitsandbytes as bnb; print(bnb)" 无异常报错,即表示库安装成功。
常见问题
Q:bitsandbytes 提供哪些量化能力?
A:README 列出 8-bit 优化器(分块量化,接近 32 位性能)与 LLM.int8() 8 位量化推理,用于大幅降低显存占用。
Q:安装后导入报错怎么办?
A:README 节选未提供排错说明,请核对 Python 与 PyTorch 版本是否匹配,或到 GitHub 仓库的 Issues 中检索同类问题。
Q:需要什么硬件才能用?
A:README 节选未给出硬件要求说明,请以 GitHub 仓库和官方文档中的最新说明为准。
Q:能配合 Hugging Face Transformers 使用吗?
A:可以,项目定位即为与 Transformers 集成,通过配置即可加载量化模型,具体参数请查阅仓库文档。
注意事项
- README 节选未直接给出安装命令,pip install 依据其 PyPI 发行链接推断,请以官方文档为准。
- 该库为 Python 库而非独立服务,没有端口、服务进程或后台常驻的概念。
- qLoRA 微调等进阶用法在节选中被截断,使用前请查阅完整仓库文档。
核心亮点
- 显存占用直降 75%,4-bit 量化让 70B 模型跑在 24G 显卡上
- 与 Transformers 无缝集成,一行代码切换量化模式
- 支持 QLoRA 微调,消费级硬件也能高效微调大模型
不足之处
- 量化后推理速度可能略慢于原生 FP16,尤其在小 batch 场景
- 文档/社区待观察,部分高级量化配置的教程不够详尽
适用场景
- 在单卡 24G 显存下部署 13B-70B 级 LLM 做推理
- 基于 QLoRA 在消费级 GPU 上微调大模型适配垂直任务
- 需要同时加载多个大模型进行对比实验的科研场景
替代项目
GPTQ-for-LLaMA、llama.cpp、AutoGPTQ
下一篇:optimate
同类项目推荐
xmtf
开源
多任务微调,让模型学会跨语言举一反三
Crosslingual Generalization through Multitask Finetuning
SkyRL
开源
把 LLM 强化学习全流程拆成乐高,多轮工具任务也能直接训
SkyRL: A Modular Full-stack RL Library for LLMs
create-stable-diffusion-from-scr···
开源
手写Stable Diffusion核心代码,从零看懂扩散模型
Implemented a stable diffusion architecture using PyTorch.
SpecForge
开源
训练投机解码模型,一键部署到 SGLang 提速
Train speculative decoding models effortlessly and port them smoothly to SGLang serv···
lora-inspector
开源
拆开 LoRA 黑盒,看清每层权重学了啥
LoRA (Low-Rank Adaptation) inspector for Stable Diffusion
Awesome-Parameter-Efficient-Fine···
开源
大模型轻量微调方法一网打尽,选型不再翻论文
Parameter-Efficient Fine-Tuning for Foundation Models
align_sd
开源
让AI画图更懂你的审美,用人类偏好微调扩散模型。
Better Aligning Text-to-Image Models with Human Preference. ICCV 2023
axolotl
开源
一条命令微调大模型,省心省力
Go ahead and axolotl questions
quaterion
开源
几分钟搭好相似度模型训练,向量检索效果快速提升
Blazing fast framework for fine-tuning similarity learning models