Automatische vertaling · Engels origineel

Aan de slag

Installeer de speech CLI om audio te transcriberen en te genereren op je Apple Silicon Mac. Gebruik de Swift SDK om spraakverwerking toe te voegen aan macOS en iOS apps.

CLI-eisen

• macOS 15+ (Sequoia of later)
• Apple Silicon (arm64)
• 8 GB RAM minimum (16 GB aanbevolen voor grotere modellen)

Installeer de CLI

Homebrew (CLI)

Native ARM gebruiken Homebrew (/opt/homebrew) te installeren speech en de speech-server HTTP/WebSocket server.

brew install speech
speech --help

Eerste taak: transcribeer een M4A bestand

Download de sample opname en transcribeer deze vervolgens in uw terminal:

Verbind met het internet voor de eerste run. De geselecteerde modeldownloads van HuggingFace en blijven gecached op je Mac. Na de installatie kun je lokale opnames offline met dat model transcriberen.

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

Doe verder met de M4A-to-text-gids.

Snelstart: tekst-tot-spraak

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

Voer een lokale spraak API uit

Start de HTTP/WebSocket server voor lokale API-verzoeken:

speech-server --port 8080

Swift SDK

Voeg de Swift modules toe aan uw macOS 15+ of iOS 18+ app met Swift Pakketbeheer.

Swift Pakketbeheer

Voeg speech-swift toe aan je Package.swift afhankelijkheden:

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

Voeg dan de modules die u nodig hebt toe aan uw doel:

.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
    ]
)

Beschikbare modules

Audio overschrijven met 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)

Speech genereren met 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"))

Bouwen uit bron

Installeer voor een broncodebouw Xcode 16.3+ met de Metal Toolchain en Swift 6+. Kloon de repository, bouw de CLI en controleer vervolgens het binaire bestand in de kassa:

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

Shader bouwt standaard naar macOS 15.0 en Metal 3.2, zelfs met nieuwere SDK's. MACOSX_DEPLOYMENT_TARGET en MLX_METAL_LANGUAGE_VERSION voor aangepaste builds; hogere targets kunnen oudere systemen uitsluiten. Compiler, SDK, vlag, script, of bronwijzigingen ongeldig maken de cache. Foute compilatie of koppeling behoudt de vorige bibliotheek en cache hash.

Modeldownloads

Modellen worden automatisch gedownload van HuggingFace bij het eerste gebruik en gecached in ~/Library/Caches/qwen3-speech/.

Alle modellen worden gedownload van HuggingFace bij eerste gebruik. Geschatte grootte:

Volgende stappen

• Doe verder met de M4A-to-text gids
• CLI Reference
• Qwen3-ASR Guide
• Qwen3-TTS Guide gedetailleerde tekst-tot-spraakdocumentatie
• API & Protocollen Gedeelde protocollen en typen