البدء

توفّر speech-swift معالجة كلام بالذكاء الاصطناعي على الجهاز لأنظمة macOS وiOS على Apple Silicon. تعمل النماذج محلّيًا باستخدام MLX (Metal GPU) وCoreML (Neural Engine).

المتطلّبات

• macOS 15+ (Sequoia أو أحدث)
• Apple Silicon (سلاسل M1 وM2 وM3 وM4)
• Xcode 15.4+ / Swift 6.0+
• 8 GB من ذاكرة الوصول العشوائي كحدّ أدنى (يُنصح بـ 16 GB للنماذج الأكبر)

التثبيت

Homebrew (CLI)

أسرع طريقة لتجربة speech-swift على macOS. يثبّت كلًّا من واجهة speech السطرية وخادم speech-server العامل عبر HTTP/WebSocket (مع نقطة نهاية /v1/realtime متوافقة مع OpenAI). يتطلّب نسخة Homebrew الأصلية لمعمارية ARM (/opt/homebrew).

brew install soniqo/tap/speech

بعد التثبيت، يتوفّر كلا الملفّين التنفيذيّين ضمن مسار PATH:

speech transcribe recording.wav
speech speak "Hello, world!" --output hello.wav
speech-server --port 8080            # خادم HTTP / WebSocket محلّي

Swift Package Manager

أضِف speech-swift إلى اعتماديّات ملفّ Package.swift:

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

ثم أضِف الوحدات التي تحتاجها إلى هدف المشروع:

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

الوحدات المتاحة

البناء من المصدر

استنسخ المستودع وابنِه:

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

بداية سريعة: تفريغ الصوت

CLI

# Transcribe a WAV file
.build/release/speech transcribe recording.wav

واجهة Swift

import Qwen3ASR

let model = try await Qwen3ASRModel.loadFromHub()
let result = try await model.transcribe(audioFile: "recording.wav")
print(result.text)

تُنزَّل النماذج تلقائيًا من HuggingFace عند أوّل استخدام، وتُخزَّن في ~/Library/Caches/qwen3-speech/.

بداية سريعة: من النص إلى الكلام

CLI

# Generate speech
.build/release/speech speak "Hello, world!" --output hello.wav

واجهة Swift

import Qwen3TTS

let model = try await Qwen3TTSModel.loadFromHub()
let audio = try await model.speak("Hello, world!")
try audio.write(to: "hello.wav")

تنزيلات النماذج

تُنزَّل جميع النماذج من HuggingFace عند أوّل استخدام. أحجام تقريبية:

الخطوات التالية

• مرجع CLI — كل الأوامر والخيارات المتاحة
• دليل Qwen3-ASR — توثيق تفصيلي لتحويل الكلام إلى نص
• دليل Qwen3-TTS — توثيق تفصيلي لتحويل النص إلى كلام
• API والبروتوكولات — البروتوكولات والأنواع المشتركة