纯 C 推理引擎,通过从磁盘按需读取路由专家,在普通硬件上运行超大混合专家(MoE)模型。
jesdga95/basalt
在 NVIDIA Blackwell 显卡上本地运行 Qwen3.8-Flash-Next 混合专家模型的推理引擎,提供兼容 OpenAI 与 Anthropic 的 API。
- Star
- 700
- Fork
- 90
- 未关闭 Issue
- 71
- 最近提交
- 20小时前
这是什么?
Basalt 是一个专为 Qwen3.8-Flash-Next 混合专家(MoE)模型打造的本地推理引擎,面向配备 NVIDIA Blackwell 显卡(计算能力 12.0,CUDA 13)的 Linux 和 Windows 机器。
放不进显存的专家层会保存在系统内存中,也可以用第二块显卡作为对等的专家层。借助这种方式,大型 MoE 模型可以在一台工作站上运行。服务端提供兼容 OpenAI 和 Anthropic 的接口,并附带可流式输出回复的网页界面。
模型以单个 `.basalt` 文件发布,其中包含权重、分词器、MTP 草稿模型、专家配置和视觉投影器。项目在 Hugging Face 上提供多种量化格式的现成模型包,并通过 JSON 配置文件和 `basalt` 命令行工具进行设置。`basalt-probe` 工具可以检测机器性能并给出推荐参数。
核心功能
- 01将放不进显存的专家层放在系统内存中,并可选用第二块显卡作为专家层。
- 02本地服务同时兼容 OpenAI 与 Anthropic 接口。
- 03内置支持流式输出的网页界面。
- 04将权重、分词器、草稿模型和视觉投影器打包进单个 .basalt 文件。
- 05提供多种量化模型包,包括 NVFP4 格式。
- 06附带 basalt-probe 工具,用于检测硬件并推荐配置参数。
适用场景
- 在单台 NVIDIA Blackwell 工作站上运行大型 MoE 模型。
- 为已有的 OpenAI 或 Anthropic 兼容客户端提供本地接口。
- 比较 Qwen3.8-Flash-Next 不同量化格式的效果与取舍。
快速上手
- 1
克隆仓库
git clone https://github.com/jesdga95/basalt && cd basalt - 2
使用 CMake 构建项目
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j - 3
安装 Python 依赖并下载模型
pip install -r requirements.txt && hf download jesdga/Qwen3.8-Flash-Next-Basalt Qwen3.8-FN-NVFP4.basalt --local-dir models - 4
使用配置文件启动服务器
bin/basalt serve --config basalt_config.json
使用前须知
- 需要配备 NVIDIA Blackwell GPU(sm_120)和 CUDA 13 的 Linux 或 Windows 系统。
- 需要足够的系统内存来存放无法放入显存的专家网络。
- 模型包采用 Qwen 社区许可证 1.0,而非 MIT 许可证。
收录于专题
标签
常见问题
- basalt 是什么?
- 在 NVIDIA Blackwell 显卡上本地运行 Qwen3.8-Flash-Next 混合专家模型的推理引擎,提供兼容 OpenAI 与 Anthropic 的 API。 Basalt 是一个专为 Qwen3.8-Flash-Next 混合专家(MoE)模型打造的本地推理引擎,面向配备 NVIDIA Blackwell 显卡(计算能力 12.0,CUDA 13)的 Linux 和 Windows 机器。
- basalt 可以免费使用吗?用的什么许可证?
- basalt 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- basalt 还在维护吗?
- 活跃维护中。basalt 最近一次提交是在 2026年11月6日。
- basalt 适合用来做什么?
- 在单台 NVIDIA Blackwell 工作站上运行大型 MoE 模型。 为已有的 OpenAI 或 Anthropic 兼容客户端提供本地接口。 比较 Qwen3.8-Flash-Next 不同量化格式的效果与取舍。
- basalt 怎么安装和运行?
- 克隆仓库: git clone https://github.com/jesdga95/basalt && cd basalt 使用 CMake 构建项目: cmake -S . -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build -j 安装 Python 依赖并下载模型: pip install -r requirements.txt && hf download jesdga/Qwen3.8-Flash-Next-Basalt Qwen3.8-FN-NVFP4.basalt --local-dir models 使用配置文件启动服务器: bin/basalt serve --config basalt_config.json
- 在哪里获取 basalt?
- 源代码和安装说明在 GitHub 上:https://github.com/jesdga95/basalt
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
基于 Rust 的本地大模型推理与服务平台,提供兼容 OpenAI 接口的 API 服务和内置 Web UI。
基于 vLLM 构建的大模型推理引擎,兼容 Hugging Face 模型并提供 OpenAI 兼容接口。
在自有 GPU 上私有运行 GLM-5.3-Flash 等大型 MoE 模型的本地推理引擎
面向 NVIDIA RTX 30 系列 Ampere 显卡(主要是 RTX 3090)优化的 llama.cpp 分支,用于本地运行 Qwen3.8 模型。
用 Zig 编写的本地大模型推理引擎,在 Apple Silicon(Metal)和 NVIDIA(CUDA)GPU 上直接提供模型服务,无需 Python 或 MLX。