argmax-oss-swift

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• macOS 开发环境与 Xcode（含 Swift 工具链）
• Apple Silicon 设备（框架面向 Apple 平台端侧推理）
• 首次拉取模型需要网络，之后可离线运行
• 熟悉 Swift Package Manager 依赖管理

安装与启动步骤

1. 1克隆项目仓库

   把仓库拉到本地作为参考，README 未提供 pip/cocoapods 类安装命令，Swift 项目一般通过依赖管理器接入。

   git clone https://github.com/argmaxinc/argmax-oss-swift.git

   复制

2. 2Xcode 中集成

   README 的 Installation 小节列出 Xcode Steps，可在 Xcode 中用 Add Package Dependencies 方式加入该仓库，具体界面步骤请对照仓库文档。

3. 3声明包依赖

   README 单独列出 Package.swift 小节，说明可在 Swift 包的 Package.swift 中声明依赖；具体版本号与写法请以仓库文件为准。

4. 4Homebrew 方式

   README 的 Installation 下另有 Homebrew 小节，说明除 SPM 外还提供 Homebrew 安装途径，公式名请查阅仓库文档。

5. 5选择所需模块

   SDK 内含 WhisperKit（语音转文字）、SpeakerKit（Pyannote 说话人分离）、TTSKit（Qwen-TTS 语音合成），按需求引入对应框架。

6. 6运行快速示例

   README 为 WhisperKit 提供 Quick Example 小节，先跑通最小示例确认模型可加载，再接入自己的工程。

如何确认成功

工程能编译通过并跑通 WhisperKit 快速示例，控制台输出转写文本或合成音频即表示接入成功。

常见问题

注意事项

• README 节选未给出具体命令、版本号与端口，步骤中的接入方式需以仓库最新文档核对。
• 项目是 Swift 库/框架，不是独立可执行服务，不存在 Docker 或服务端口部署。
• 需使用 Apple 生态设备与 Xcode 开发环境，非 Apple 平台无法直接使用。
• Pro 版额外提供实时带说话人转写、自定义词汇与 Argmax Local Server 等功能。