# Core AI Models - 苹果官方端侧AI模型工具库（开源模型一键导出.aimodel跑Mac/iPhone）

> 苹果官方出品：把HuggingFace开源模型导成Core AI格式跑进Mac和iPhone，还教AI助手按苹果规则干活

苹果官方出品的端侧 AI 工具仓库：把 HuggingFace 上的开源模型导出成苹果 Core AI 格式，跑在 Mac 和 iPhone 上。模型导出配方、PyTorch 构建原语、Swift 运行时工具、Agent 技能包，四件套齐活。

## 里面有什么

| 目录 | 内容 |
|------|------|
| models/ | 模型目录 + 导出配方，每个模型一份 README 说明怎么导 |
| python/ | 用 PyTorch 写端侧模型的 Python 原语，以及导出工具 |
| swift/ | Swift 包（coreai-models）：把 Core AI 模型集成进 App 的运行时工具 |
| skills/ | 给 coding agent 用的插件技能，让 AI 按苹果的规则玩 Core AI |

导出的模型是独立的 `.aimodel` 文件，通过 Core AI 框架直接集成进 App。语言模型要带 tokenizer、扩散模型要多模型串成 pipeline 的，导出配方会生成一个资源文件夹，把 `.aimodel` 和所需资源打包在一起。仓库还带 CLI 工具，Mac 上直接跑导出的模型（需 Xcode 27.0+）。

## 想跑哪些模型

克隆仓库后一行命令列出全部支持模型：

```
uv run coreai.model.registry --list-models
```

## Agent Skills 是个亮点

仓库内置了三个技能，教 Claude Code / Codex / Gemini CLI 像 expert 一样用 Core AI：

- **working-with-coreai**：PyTorch 模型上苹果芯片的端到端流程——coreai-torch 导出 + Core AI 运行时跑起来
- **model-authoring**：端侧建模的经验规则——BC1S 布局、算子兼容性、KV cache 模式、精度规则、MoE，全是踩坑总结
- **model-compression-exploration**：用 coreai-opt 系统性探索量化/查表压缩配置

安装走插件市场：Claude Code `/plugin marketplace add` + `/plugin install coreai-skills@coreai-models`，Codex CLI 同样有 marketplace 命令，Gemini CLI 用 extensions install。

## 环境要求

- 导出：uv（brew install uv 一行装好），按 models/ 里各模型的配方走
- 运行与 App 集成：macOS / iOS 27.0+，Xcode 27.0+

## 项目信息

- Apple 官方 org 下的开源仓库，2026-06-08 创建，2.2k star
- 定位是 Core AI 生态的模型层：苹果框架管运行时，这个仓库管"模型怎么进来"
- 对做端侧 AI App、想把开源大模型塞进 iPhone/Mac 的开发者是官方正路入口

---

**分类**：软件
**标签**：模型 · AI · 导出
**作者**：子龙
**链接**：https://octohz.com/p/3375