תרגום מכונה · המקור באנגלית

תחילת העבודה

התקן את speech CLI to transcribe and Create אודיו על שלך Apple Silicon Macהשתמש ב Swift SDK להוסיף עיבוד דיבור macOS ו iOS יישומים.

דרישות CLI

• macOS 15+ (Sequoia או מאוחר יותר)
• Apple Silicon (arm64)
• 8 GB RAM מינימום 16 GB מומלץ עבור מודלים גדולים יותר

התקן את CLI

Homebrew (CLI)

שימוש ב-ARM Homebrew (/opt/homebrew) להתקין speech וה speech-server HTTP / WebSocket Server.

brew install speech
speech --help

משימה ראשונה: לרשום קובץ M4A

הורד את הקלטת הדגימה, ולאחר מכן לנטר אותה במסוף שלך:

להתחבר לאינטרנט עבור הראשון לרוץ.המודל שנבחר מוריד מ HuggingFace ונשאר תקוע על Mac לאחר ההתקנה, אתה יכול לנטר הקלטות מקומיות ללא הפרעה עם מודל זה.

curl -fL https://soniqo.audio/audio/samples/cli/transcription-sample.m4a -o transcription-sample.m4a
speech transcribe transcription-sample.m4a --engine parakeet

המשך עם M4A-to-text מדריכים.

התחל מהיר: טקסט-to-Speech

speech speak "Hello, world!" --output hello.wav

הפעל נאום מקומי API

התחל את שרת HTTP / WebSocket עבור בקשות API המקומי:

speech-server --port 8080

Swift SDK

הוסף את Swift מודולים עבור macOS 15+ או iOS 18+ אפליקציה עם Swift מנהל החבילה.

Swift מנהל החבילה

הוסף speech-swift ל Package.swift

dependencies: [
    .package(url: "https://github.com/soniqo/speech-swift", branch: "main")
]

לאחר מכן להוסיף את המודולים שאתה צריך למטרה שלך:

.target(
    name: "MyApp",
    dependencies: [
        .product(name: "Qwen3ASR", package: "speech-swift"),
        .product(name: "Qwen3TTS", package: "speech-swift"),
        .product(name: "SpeechVAD", package: "speech-swift"),
        // ... add any modules you need
    ]
)

מודולים זמינים

עקבו אחרי Swift

import Qwen3ASR

let model = try await Qwen3ASRModel.fromPretrained()
// audioSamples: [Float] PCM at 16 kHz (e.g. decoded from a WAV)
let text = model.transcribe(audio: audioSamples, sampleRate: 16000)
print(text)

צור קשר עם Swift

import Qwen3TTS
import AudioCommon

let model = try await Qwen3TTSModel.fromPretrained()
let audio = model.synthesize(text: "Hello, world!", language: "english")
try WAVWriter.write(samples: audio, sampleRate: 24000, to: URL(filePath: "hello.wav"))

בנייה ממקור

עבור יצירת מקור, להתקין Xcode 16.3+ עם Metal Toolchain ו Swift 6+. Clone the repository, לבנות את CLI, ולאחר מכן לבדוק את בינארי בקופה:

git clone https://github.com/soniqo/speech-swift.git
cd speech-swift
make build
.build/release/speech --help

Shader בונה ברירת מחדל macOS 15.0 ו Metal 3.2, אפילו עם SDKs חדשים יותר.Override אלה עם MACOSX_DEPLOYMENT_TARGET ו MLX_METAL_LANGUAGE_VERSION

דגם Downloads

מודלים מורידים באופן אוטומטי מ- HuggingFace לשימוש ראשון ודחוסים לשימוש ראשון. ~/Library/Caches/qwen3-speech/.

כל המודלים הורדו מ HuggingFace

צעדים הבאים

• המשך עם M4A-to-text מדריכים
• CLI Reference - כל הפקודות והאפשרויות הזמינות
• Qwen3-ASR Guide - תיעוד דיבור מפורט לטקסט
• Qwen3-TTS Guide - תיעוד טקסט מפורט ל-Speech
• API & פרוטוקולים - פרוטוקולים משותפים וסוגים