
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-15 · 当前星标 ★ 1949
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 环境,且可使用 pip3 安装包
- 已安装 PyTorch(示例代码中 import torch)
- 使用 HuggingFace 用法时需安装 transformers
- 示例代码使用 CUDA 与 float16,如需照抄示例建议有 NVIDIA 显卡
安装与启动步骤
-
1安装 bitnet
README 给出的唯一安装方式,直接用 pip3 从 PyPI 安装 bitnet 包,建议在虚拟环境中执行。
pip3 install bitnet -
2验证导入成功
安装完成后导入包内函数,确认环境无缺失依赖,能导入即说明基础安装成功。
python -c "from bitnet import replace_linears_in_hf" -
3用 BitLinear 替换线性层
BitLinear 内部流程为 tensor→layernorm→二值化→abs max 量化→反量化;把 Transformer 里的 nn.Linear 换成 BitLinear,还可把 BitLinear 接入注意力得到 BitMGQ
-
4替换 HuggingFace 模型
README 示例从 bitnet 导入 replace_linears_in_hf,用于把 HuggingFace 模型中的线性层批量替换为 BitLinear,随后即可加载模型推理。
import torch from transformers import AutoModelForSequenceClassification, AutoTokenizer from bitnet import replace_linears_in_hf -
5参考示例脚本
README 指出 examples 目录下有大量示例脚本,按自己的使用场景挑选对应脚本阅读或运行,具体文件名请以仓库 examples 文件夹为准。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
device | 否 | 示例张量所在设备,README 中统一使用 CUDA | cuda |
dtype | 否 | 示例张量精度,README 中统一使用半精度 | torch.half |
w_scale | 否 | 权重量化使用的缩放因子示例值 | 1.0 |
x_scale | 否 | 激活量化使用的缩放因子示例值 | 1.0 |
如何确认成功
能执行 python -c "from bitnet import replace_linears_in_hf" 且无报错,即表示 bitnet 包安装成功。
常见问题
Q:可以只用 CPU 运行吗?
A:README 的示例张量都写在 device='cuda' 且用 torch.half,说明默认面向 GPU;纯 CPU 运行需自行把设备改为 cpu 并注意半精度支持问题,README 未给出 CPU 示例。
Q:怎么把已有 HuggingFace 模型改成 BitNet?
A:README 提供了 replace_linears_in_hf,从 bitnet 导入后对模型调用即可将线性层替换为 BitLinear,再配合 AutoModelForSequenceClassification/AutoTokenizer 使用。
Q:BitLinear 1.5 可以用了吗?
A:README 明确说 BitLinear 1.5 仍在开发中,反量化算法等还有 bug,且尚未把乘法换成逐元素加法,暂不建议用于正式场景。
Q:具体示例脚本怎么跑?
A:README 只说示例在 examples 文件夹中,没有给出脚本名和运行命令;请打开仓库 examples 目录按文件名自行选择。
注意事项
- 本仓库是论文的 PyTorch 研究实现,README 未提供训练数据集、显存需求或性能指标。
- BitLinear 1.5 与 1.58-bit 新迭代仍在开发中,存在已知 bug,不建议直接用于生产。
- README 中的量化/反量化只给出流程描述与缩放因子示例,具体数值需按自己的模型调整。
核心亮点
- 提供完整 BitLinear 三值线性层实现,可直接替换 nn.Linear 做量化训练
- 代码基于 PyTorch,结构清晰,便于二次修改和复现论文实验
- 支持在消费级显卡上训练小规模类 GPT 模型,降低低比特研究门槛
不足之处
- 仅实现论文核心思路,缺少大规模预训练权重与完整评测结果
- 仓库更新与社区活跃度有限,文档和示例相对简单
适用场景
- 研究 1-bit/三值量化对语言模型效果的影响
- 在显存有限的设备上训练小型 GPT 类模型
- 作为低比特 Transformer 教学与论文复现的代码参考
替代项目
GPTQ-for-LLaMa、llama.cpp、bitsandbytes
上一篇:Qwen3.8
同类项目推荐
AIGC-progress
开源
一张清单,跟上AIGC所有热点模型与应用
Follow the rapid development of AIGC models and applications. | 跟上AIGC模型和应用快···
GPT-Models-Plus
开源
一个脚本搞定 ChatGPT、Claude、Grok 多模型调用
别问我为什么大杂烩放在一块,懒得新建项目
RETFound
开源
拿医学影像直接预训练,少标注也能做AI诊断
Vision Foundation Models for Medical AI, including RETFound, DINOv2, DINOv3
Awesome-AVI
开源
一站式导航音频-视觉智能前沿资源,快速上手跨模态研究
Awesome Audio-Visual Intelligence, Survey of Audio-Visual Intelligence
Skywork
开源
开源中英双语大模型,数据权重全开放,快速训练部署
Skywork series models are pre-trained on 3.2TB of high-quality multilingual (mainly ···
nuwa-pytorch
开源
用文本生成视频的PyTorch实现,体验女娲模型
Implementation of NÜWA, state of the art attention network for text to video synthe···
ChatGLM2-6B
开源
消费级显卡跑双语大模型,对话推理快人一步
ChatGLM2-6B: An Open Bilingual Chat LLM | 开源双语对话语言模型
MiniCPM
开源
手机就能跑的小模型,离线对话不联网
MiniCPM5: SOTA on-device LLMs, small yet powerful.
tapestry
开源
联合全球力量,训练属于你的主权AI模型
Project Tapestry aims to give every nation and participant frontier AI they can call···