ds4 是什么?

DwarfStar(ds4)是一个刻意做窄的本地大模型推理引擎,用 C、Metal、CUDA 和 ROCm 针对少数大模型与高内存消费级硬件优化。它不是通用 GGUF runner,必须使用项目生成或指定的 GGUF。

⭐ 18,098 Stars 🍴 1,556 Forks C MIT 作者: antirez
来源:github.com/antirez/ds4 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目把模型加载、量化、KV 状态、HTTP 服务、原生 coding agent、正确性测试和性能基准放在同一仓库里。旧页面只写 DeepSeek V4 Flash 已经过期;当前 README 还列出 DeepSeek V4.1 Flash/PRO、GLM 5.2/5.3、GLM 5.3 Flash 和 Qwen3.8 Flash Next,具体支持随主分支快速变化。

来源:github.com/antirez/ds4

核心功能

Metal、CUDA 与 ROCm 后端

主要面向 96GB+ Apple Silicon、DGX Spark、一般 CUDA 多卡和 Strix Halo/Framework Desktop。

来源:github.com/antirez/ds4
SSD streaming 与持久化 KV 状态

内存不足时可用 SSD streaming;原生 Agent 会把兼容会话存到 ~/.ds4/kvcache,保存内容可能含私密对话和轨迹。

来源:github.com/antirez/ds4
CLI、HTTP server 与原生 coding agent

提供 ds4、ds4-server 和 ds4-agent;服务器默认监听 127.0.0.1:8000,兼容多种常见 API 入口。

来源:github.com/antirez/ds4 (1) · github.com/antirez/ds4/blob/main/docs/SERVER.md (2)

技术架构

核心推理代码与 Metal/CUDA/ROCm 后端直接配合,模型、GGUF/量化工具、KV store、CLI、server、agent、评测和测试共同版本化。项目通过 platform-specific make target 选择后端;HTTP server 暴露 chat/completions、responses、completions 和 messages 接口。

来源:github.com/antirez/ds4

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 项目指定 GGUF 目标平台 GPU 工具链目标平台 GPU 工… 大量内存或 SSD streaming大量内存或 SSD… Metal、CUDA 与 ROCm 后端Metal、CUDA 与 ROCm… SSD streaming 与持久化 KV 状态SSD streaming 与持… CLI、HTTP server 与原生 coding agentCLI、HTTP server 与… ds4 项目本体 核心功能 关键依赖

技术栈

语言C、Objective-C/Metal、CUDA C++,另有 ROCm 支持框架自包含推理引擎与本地 HTTP server
项目指定 GGUF目标平台 GPU 工具链大量内存或 SSD streaming
Apple Silicon、DGX Spark、一般 CUDA 多卡或 Strix Halo;默认本地服务端口 8000
来源:github.com/antirez/ds4 (1) · github.com/antirez/ds4/blob/main/docs/MODELS.md (2)

快速上手

克隆仓库后按硬件选择 make、make cuda-spark、make cuda-generic 或 make strix-halo;96/128GB 机器的官方首次示例用 ./download_model.sh ds4f-q2,再运行 ./ds4。权重很大,下载和编译前必须先读对应平台指南、检查磁盘空间与内存。
来源:github.com/antirez/ds4

使用场景

适合有 96GB+ Mac、DGX Spark、Strix Halo 或合适 CUDA 多卡的开发者研究本地大模型推理、长上下文、SSD streaming、多会话服务与 coding agent 接入。普通内存设备或需要多模型即插即用时不适合。

来源:github.com/antirez/ds4

优势与局限

优势

  • 针对少数模型把推理、服务、Agent、测试和基准一起维护
  • 支持 Metal、CUDA、ROCm、SSD streaming 和部分多机/多卡方案
  • 文档明确区分 capability regression 与官方排行榜

局限

  • beta 且主分支变化快,仓库没有 GitHub Release 或 tag
  • 硬件、内存、磁盘和模型权重门槛高
  • 不是通用 GGUF runner,模型可能随项目选择变化
来源:github.com/antirez/ds4

最新版本

截至 2026-09-23,官方 GitHub API 没有 release 或 tag;项目通过快速变化的 main 分支开发,README 明确标为 beta。版本核对必须记录 commit,而不能编造 release 号。

来源:github.com/antirez/ds4

实测与证据

status: official_docs_checked_not_built_or_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、MODELS、SERVER、CLIENTS、TESTING、GitHub API 的 releases/tags 与仓库元数据;未下载权重、编译或运行  |  limitations: 未验证硬件兼容、权重哈希、token/s、SSD 寿命、量化质量、API 兼容性或多机配置  |  observed_output: 官方资料确认四种 build target、ds4f-q2 下载入口、ds4/ds4-agent/ds4-server、默认 127.0.0.1:8000、beta 状态和当前无 release/tag

来源:github.com/antirez/ds4

同类项目对比

ds4 官方把自己定义为少数模型的专用引擎,并要求项目指定 GGUF;llama.cpp 面向更广泛模型与硬件,强调最少依赖和通用本地推理。需要通用兼容性时优先 llama.cpp;硬件和模型正好落在 ds4 优化范围、愿意跟随 beta 主分支时再选 ds4。

来源:github.com/antirez/ds4 (1) · github.com/ggml-org/llama.cpp (2)

总结评价

适合具备高内存 Mac、DGX Spark、Strix Halo 或合适 CUDA 多卡,并愿意测试 beta 专用推理路径的用户。先确认模型、后端、内存和磁盘,再决定是否下载权重;需要通用本地模型 runner 时应优先评估 llama.cpp。

来源:官方 README 与文档入口

常见问题

ds4 现在只支持 DeepSeek V4 Flash 吗?

不是。当前 README 还列出 DeepSeek V4.1 Flash/PRO、GLM 5.2/5.3、GLM 5.3 Flash 和 Qwen3.8 Flash Next;具体后端支持查 MODELS 文档。

普通 32GB 或 64GB Mac 适合运行 ds4 吗?

官方主要目标是 96GB+ Mac。小内存设备可能依赖 SSD streaming,但模型、上下文和速度限制明显。

ds4-server 可以直接暴露到公网吗?

不应直接暴露。官方要求公网部署自行增加认证和 TLS;CORS 不提供访问控制。

ds4 与 llama.cpp 怎么选?

要广泛模型和通用生态时选 llama.cpp;目标模型和硬件在 ds4 优化清单内,并能接受 beta 迭代时再评估 ds4。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 10:52.

参考材料:README、GitHub API、依赖文件