← 返回列表

Yunshu:面向 Apple Silicon 的本地 LLM/VLM 推理引擎

YuhuanStudio/Yunshu · Fast local LLM / VLM inference engine for Apple Silicon (MLX). OpenAI- and Anthropic-compatible, lossless speculative decoding (DFlash2 / MTP), hybrid-model prefix cache with RAM/SSD tiers, native Claude Code / Codex / opencode support. Qwen3.8-27B tuned first.

GitHub原文发布 未知首次收录 2026-10-16上架 2026-10-25 09:01

☆ 收藏查看项目 ↗

ELI5:它是什么,解决什么问题

Yunshu 是一个基于 MLX、在 Apple Silicon 上本地运行的 LLM 与 VLM 推理引擎,单进程提供 OpenAI、Anthropic 和 Ollama 兼容 API。它支持无损的推测解码(DFlash2、MTP、prompt-copy drafting)、面向混合模型的前缀缓存(RAM、SSD 及可选存储层级)、结构化输出、多模态输入、Web 搜索与 MCP、编码代理(Claude Code、Codex、opencode)接入,以及包含密钥配额、主机遥测和评测的本地 Web 控制台。首个完整调优模型为 Qwen3.8-27B。

核心能力与快速开始

★ 3 · Python

能做什么
在 Apple Silicon 上通过 MLX 本地运行 LLM/VLM 推理;提供 OpenAI Chat/Completions/Responses/Embeddings/Files/Batches、Anthropic Messages 及 Ollama 兼容接口;支持 DFlash2、MTP 与 prompt-copy 三种推测解码方式,并声称在使用推测解码时,贪心输出与不使用推测解码时逐 token 一致;为混合模型(注意力 + GatedDeltaNet)提供 RAM/SSD 分层前缀缓存,且重启后仍然有效;支持 JSON schema、正则、选择和语法约束的结构化解码;支持图像、音频、视频输入及语音实时交互(部分能力标注为部分或实验性);提供服务端 web_search/web_fetch 与 MCP;支持 Claude Code、Codex、opencode 等编码代理接入;含本地 Web 控制台、多 API 密钥与配额、主机遥测、评测和存储型补全记录。
适用场景
在单台 Mac 上以低延迟方式本地部署 LLM/VLM,并通过现有 OpenAI/Anthropic SDK 无改动接入;为编码代理提供本地推理后端;对重复长提示或多轮 Agent 场景利用前缀缓存降低重复计算;需要结构化 JSON 输出或工具调用参数约束的应用;通过 Web 控制台监控请求阶段、延迟、缓存命中和主机功耗温度。
项目形态
可直接使用的工具
部署方式
本地部署:以 uv tool 或 Homebrew 安装,运行 yunshu serve 后监听 http://127.0.0.1:8000,控制台监听 8100;也可从源码构建,或在前端目录用 pnpm 开发控制台。
主要依赖
Apple Silicon、macOS 14+、Python 3.13+、uv;可选 vision 扩展。模型默认存放于 ~/.yunshu/models。具体内存与模型适配要求未在摘录中完整说明,可用 yunshu doctor -m 检查。
使用限制
仅面向 Apple Silicon(MLX),未说明支持其他硬件;部分能力(大 MoE 加载、语音到语音、Round driver)标注为部分或实验性;有损内存选项默认关闭;API 成本、并发上限与具体性能数值未说明;未说明是否经过实际安装验证。
许可证
Apache-2.0
最近推送
2026-10-15 08:42

资料检查:2026-10-16 07:00 · 卡片整理:2026-10-25 09:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证

这是基于来源内容整理的摘要。原文链接失效后,本页摘要和讨论仍会保留。

讨论 0

登录后参与讨论,阅读资讯无需注册。

还没有评论,来分享第一个看法。