mlx-omni-server

在 Mac 上本地跑多模态 AI,OpenAI 接口无缝接入

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 音频音乐 🍴 复刻 88 🐛 待处理 25 👀 关注 12
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 746
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,本地部署,完全免费。

项目预览

mlx-omni-server 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类音频音乐
开发团队madroidmaq
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,本地部署,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型function-calling,genai,mlx,openai,openai-api,structured-output,stt,tools,tts
GitHub 星标★ 746
上线时间2024-11-05 00:00:00
代码更新2026-05-09
仓库体积5.6 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

mlx-omni-server 是一个基于 Apple MLX 框架的本地推理服务器,专为 Apple Silicon(M 系列)芯片优化。它实现了与 OpenAI 兼容的 API 端点,让现有 OpenAI SDK 客户端能无缝接入本地多模态模型,支持语音转文字(STT)、文字转语音(TTS)、函数调用和结构化输出等功能。该项目解决了在 Mac 上高效运行本地大模型并集成到现有应用的问题,无需依赖云端 API,兼顾隐私和成本。核心能力包括:利用 MLX 框架充分发挥 Apple 芯片的神经网络加速性能,提供统一的 OpenAI 风格接口,支持工具调用和结构化数据生成,适合开发者构建本地 AI 助手或原型。目前项目处于早期阶段(734 星),但已具备完整的推理服务框架,是 Apple 生态内本地 AI 部署的有力工具。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 746

使用教程

难度:进阶 约 25 分钟 部署方式:本地服务 4 步

环境要求

  • Apple Silicon Mac
  • Python 3.11+

安装与启动步骤

  1. 1装包

    从包管理器装。

    pip install mlx-omni-server
  2. 2起服务

    用命令行直接起,默认端口固定。

    mlx-omni-server --help
  3. 3开发模式

    改源码时用 uvicorn 起。

    uv run uvicorn mlx_omni_server.main:app --reload --host 0.0.0.0 --port 10240
  4. 4验环境

    确认 MLX 可用再下模型。

    python -c "import mlx; print(mlx.__version__)"

如何确认成功

接口返回模型列表,发一条对话请求能拿到流式回复。

注意事项

  • 它把 MLX 模型包装成 OpenAI 兼容接口,客户端不用改代码。
  • 只支持 Apple Silicon,Intel 机器装不上 MLX。

核心亮点

  • 针对 Apple Silicon 深度优化,推理性能优于通用框架
  • OpenAI 兼容 API,现有项目改个 base_url 即可切换
  • 集成 STT/TTS/函数调用,一个服务搞定多模态需求

不足之处

  • 仅支持 Apple Silicon,非 Mac 用户无法使用
  • 早期项目,文档和生态待完善

适用场景

  • 在 Mac 上开发本地 AI 助手,需要语音交互和工具调用
  • 隐私敏感场景,数据不出本机,但需 OpenAI 兼容接口
  • 快速原型验证,用现有 OpenAI SDK 代码直接对接本地模型

替代项目

Ollama、LocalAI、llama.cpp

上一篇:gpt_server

下一篇:zerolan-core

同类项目推荐

cortex 开源

统一管理多模型和智能体工具,一键切换后端AI服务

Open-source AI backend control plane for model routing, agent tools, OpenAI-compatib···

★ 66 2026-08-09
logto 开源

开箱即用的登录与权限系统,让 SaaS 和 AI 应用快速上线认证

‍ Authentication and authorization infrastructure for SaaS and AI apps, built on OI···

★ 14870 2026-10-17
openlake 开源

加速 LLM 训练与推理,让 GPU 不再等数据

OpenLake is a high performance storage engine for efficient LLM inference and GPU Tr···

★ 2903 2026-08-09
llmserve 开源

终端里选模型选后端,一键把本地 LLM 跑起来

A simple TUI for serving local LLM models. Pick a model, pick a backend, serve it

★ 417 2026-09-16
llm-graph-builder 开源

上传文档,一键用LLM自动生成知识图谱

Neo4j graph construction from unstructured data using LLMs

★ 5301 2026-08-09
claw-compactor 开源

超长对话自动压缩,花小钱办大事不丢内容

14-stage Fusion Pipeline for LLM token compression — reversible compression, AST-aw···

★ 2005 2026-08-09
mixtral-offloading 开源

让 8x7B 大模型在低配电脑上跑起来

Run Mixtral-8x7B models in Colab or consumer desktops

★ 2334 2026-08-09
lucebox 开源

消费级显卡也能跑出更快的本地大模型推理

LLM speculative inference server for heterogeneous hardware & consumer GPUs

★ 2980 2026-09-16
doubao2api 开源

把豆包变成 OpenAI 接口,免费多模态调用

Reverse-engineered Doubao (豆包) API → OpenAI-compatible REST service. Free multimo···

★ 315 2026-08-09