Foundation-Models-Framework-Lab

用 Apple 官方框架，快速搭建和测试你的 AI 应用。

这是一个基于 Apple 新发布的 Foundation Models 框架的实战实验室，旨在帮助开发者快速上手构建、测试和评估基于 Apple 基础模型的应用程序。它解决了 Apple 开发者面对新框架时缺乏示例和最佳实践的问题，提供了可运行的代码示例、测试工具和评估流程。核心能力包括：集成 Foundation Models 框架进行文本生成、对话等任务，结合 HealthKit 等系统能力构建上下文感知应用，并提供一套模块化的项目结构，方便开发者扩展和复用。项目使用 Swift 编写，面向 iOS 生态，适合希望探索 Apple 生成式 AI 能力的开发者。

开源 free 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1185

维护状态活跃

是否开源是

定价模式 free

项目数据

分类音频音乐

开发团队rudrankriyam

所属国家

官网地址

GitHubhttps://github.com/rudrankriyam/Foundation-Models-Framework-Lab

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言Swift

技术栈/模型ai,apple-foundation-models,apple-intelligence,foundation-models,foundation-models-framework,generative-ai,healthkit,ios,large-language-models,llm,macos,multilingual,on-device-ai,rag,speech-recognition,swift,swiftui,text-to-speech,tool-calling,xcode

GitHub 星标★ 1185

30天Star增速

HF 下载量

上线时间2025-06-09 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

macOS 系统，并已安装 Xcode（项目为 .xcodeproj 工程）
用于实时模型执行的兼容物理设备（真机）
iOS Simulator 可用于编译与界面验证
能访问 GitHub 拉取仓库的网络环境

安装与启动步骤

1克隆仓库

把项目源码克隆到本地任意目录，仓库名即 Foundation-Models-Framework-Lab。
```
git clone https://github.com/rudrankriyam/Foundation-Models-Framework-Lab.git
```
2进入项目目录

切换到克隆下来的目录，后续的打开与构建命令都在此目录执行。
```
cd Foundation-Models-Framework-Lab
```
3用 Xcode 打开

用 Xcode 打开 FoundationLab.xcodeproj，可浏览 Library、Playground、Runs 三个入口。
```
open FoundationLab.xcodeproj
```

4命令行构建 macOS

对 macOS 平台做一次不签名的构建，验证代码是否可以编译通过。

xcodebuild 
  -project FoundationLab.xcodeproj 
  -scheme 'Foundation Lab' 
  -destination 'generic/platform=macOS' 
  CODE_SIGNING_ALLOWED=NO 
  build

5构建 iOS 模拟器

对 iOS Simulator 做一次不签名构建，用于编译与界面验证。

xcodebuild 
  -project FoundationLab.xcodeproj 
  -scheme 'Foundation Lab' 
  -destination 'generic/platform=iOS Simulator' 
  CODE_SIGNING_ALLOWED=NO 
  build

6真机运行模型

实时模型执行必须使用兼容的物理设备，模拟器只能验证编译与界面。

关键配置

配置项	必填	说明	示例
`CODE_SIGNING_ALLOWED`	否	命令行构建时关闭代码签名，便于无证书构建	`NO`

如何确认成功

xcodebuild 输出构建成功信息，且在 macOS、iOS 模拟器或真机上能打开 App 界面。

常见问题

Q：模拟器能运行真实模型吗？

A：不能。README 明确说明实时模型执行需要兼容的物理设备，模拟器只适合编译和界面验证。

Q：必须安装 Xcode 吗？

A：是。项目以 FoundationLab.xcodeproj 工程分发，README 只给出用 Xcode 打开和 xcodebuild 构建两种方式。

Q：支持哪些平台？

A：原生 iOS 和 macOS，README 中的构建目标分别是 generic/platform=macOS 与 generic/platform=iOS Simulator。

Q：仓库里有哪些可上手的内容？

A：Library 提供 18 个可编辑 recipe、14 个引导 lab 和三个 workshop，可在 Playground 中修改并立即运行。

注意事项

实时模型执行需要兼容的物理设备，模拟器构建仅用于编译与界面检查。
README 只给出 Xcode 工程与 xcodebuild 两种构建路径，未提供其他安装脚本或依赖安装步骤。
真机运行需在 Xcode 中自行处理代码签名，命令行示例使用了 CODE_SIGNING_ALLOWED=NO。

核心亮点

紧跟 Apple 官方新框架，提供一手实践示例，学习价值高
示例代码结构清晰，模块化设计，易于理解和二次开发
结合 HealthKit 等系统能力，展示 AI 与系统服务融合的玩法

不足之处

依赖 Apple 新框架，需特定系统版本，上手门槛较高
文档/社区待观察

适用场景

学习 Apple Foundation Models 框架的入门教程
快速原型验证：在 iOS 上测试生成式 AI 功能
探索 AI 与健康数据结合的应用开发

替代项目

LangChain.swift、Swift Transformers、MLX Swift

项目介绍

Foundation-Models-Framework-Lab 是开发框架领域的开源项目，由 rudrankriyam 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,185）位列前 30%，在开发框架分类中处于中上游。

近 45 天，它的 GitHub 星标从 1,165 增加到 1,185，净增 20。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：学习AppleFoundationModels框架的入门教程。同类可对比的替代方案包括 LangChain.swift、Swift Transformers、MLX Swift。

上一篇：react-native-executorch

下一篇：go-astibob