Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
IchenDEV merged 1 commit into from
Aug 24, 2026
Merged

Run Qwen3-ASR natively in Swift #82

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 12 additions & 3 deletions Package.resolved
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 4 additions & 2 deletions Package.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
],
dependencies: [
.package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
.package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
.package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
.package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
.package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
],
targets: [
.executableTarget(
name: "OpenType",
dependencies: [
.product(name: "WhisperKit", package: "argmax-oss-swift"),
.product(name: "MLXAudioCore", package: "mlx-audio-swift"),
.product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
.product(name: "Hub", package: "swift-transformers"),
.product(name: "Tokenizers", package: "swift-transformers"),
.product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
.copy("Resources/SettingsStyleIllustration.png"),
.copy("Resources/SettingsIntegrationsIllustration.png"),
.copy("Resources/SettingsAboutIllustration.png"),
.copy("Resources/Scripts"),
.copy("Resources/Sounds"),
.copy("Resources/AppIcon.icns"),
.copy("Resources/AppIconLight.icns"),
Expand Down
7 changes: 3 additions & 4 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down
29 changes: 5 additions & 24 deletions Sources/App/VoicePipeline+Models.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

func unloadLocalASR() {
qwenSpeechEngine = nil
mimoSpeechEngine = nil
}

func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
markSpeechModelDownloadRequired(showInStatus: requestPermission)
return
}
let engine = LocalASREngine(configuration: LocalASRConfiguration(
provider: .qwen3,
pythonPath: settings.localASRPythonPath,
modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
tokenizerPath: "",
repoPath: ""
))
let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
let engine = QwenNativeASREngine(modelPath: modelPath)
qwenSpeechEngine = engine
Task { await engine.prepare() }
case .mimo:
let settings = appState.settings
let catalog = ModelCatalog.shared
guard localASRIsAvailable(settings.mimoASRModel) else {
mimoSpeechEngine = nil
markSpeechModelDownloadRequired(showInStatus: requestPermission)
return
}
let engine = LocalASREngine(configuration: LocalASRConfiguration(
provider: .mimo,
pythonPath: settings.localASRPythonPath,
modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
tokenizerPath: catalog.mimoTokenizerPath(),
repoPath: catalog.mimoRepositoryPath()
))
mimoSpeechEngine = engine
Task { await engine.prepare() }
appState.settings.speechEngine = .apple
await ensureEngineLoaded(requestPermission: requestPermission)
}
}

Expand Down
4 changes: 1 addition & 3 deletions Sources/App/VoicePipeline+Status.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
return error.localizedDescription
case let error as AppleSpeechError:
return error.localizedDescription
case let error as LocalASRError:
return error.localizedDescription
case let error as LocalASRRuntimeError:
case let error as QwenNativeASRError:
return error.localizedDescription
case is URLError:
return L("error.network_request_failed")
Expand Down
5 changes: 2 additions & 3 deletions Sources/App/VoicePipeline.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
var whisperEngine: WhisperEngine?
var appleSpeechEngine: AppleSpeechEngine?
var volcSpeechEngine: VolcSpeechEngine?
var qwenSpeechEngine: LocalASREngine?
var mimoSpeechEngine: LocalASREngine?
var qwenSpeechEngine: QwenNativeASREngine?
var screenOCRTask: Task<ScreenContextSnapshot, Never>?
var screenOCRStartedAt: CFAbsoluteTime?
var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
case .apple: return appleSpeechEngine
case .volc: return volcSpeechEngine
case .qwen3: return qwenSpeechEngine
case .mimo: return mimoSpeechEngine
case .mimo: return nil
}
}

Expand Down
15 changes: 0 additions & 15 deletions Sources/Config/ASRDownloadError.swift
View file
Open in desktop

This file was deleted.

32 changes: 17 additions & 15 deletions Sources/Config/AppSettings.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
case qwen3 = "qwen3"
case mimo = "mimo"

static var selectableCases: [SpeechEngineType] {
allCases.filter { $0 != .mimo }
}

var label: String {
switch self {
case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
@Published var volcAppKey: String
@Published var volcAccessKey: String
@Published var volcResourceId: String
@Published var localASRPythonPath: String
@Published var qwenASRModel: String
@Published var mimoASRRepoPath: String
@Published var mimoASRModel: String
@Published var preloadSpeechModelOnLaunch: Bool
@Published var preloadFormattingModelOnLaunch: Bool
@Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
case menuBarIcon, appIconAppearance
case volcAppKey, volcAccessKey, volcResourceId
case localASRPythonPath
case qwenASRModel, qwenASRModelPath
case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
?? .longPress
tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
?? .apple
speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
if loadedSpeechEngine == .mimo {
ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
}
[
"localASRPythonPath",
"mimoASRRepoPath",
"mimoASRModel",
"mimoASRModelPath",
"mimoASRTokenizerPath",
].forEach(ud.removeObject(forKey:))
whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
?? LocalASRConfiguration.qwen3DefaultModel
mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
?? LocalASRConfiguration.mimoDefaultModel
?? QwenASRModel.defaultID
preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
$volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
$volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
$volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
$localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
$qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
$mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
$mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
$preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
$preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
$modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down
5 changes: 1 addition & 4 deletions Sources/Config/ModelCatalog.swift
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
}
if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
}
if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
settings.qwenASRModel = QwenASRModel.defaultID
}
refreshStatus()
}
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
Run Qwen3-ASR natively in Swift#82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

IchenDEV
merged 1 commit into

from

Aug 24, 2026
 Merged


Run Qwen3-ASR natively in Swift
#82
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


1 commit


Select commit


File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


15 changes: 12 additions & 3 deletions
Package.resolved

View file


Open in desktop


Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.


6 changes: 4 additions & 2 deletions
Package.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,14 +13,17 @@ let package = Package(
 ],
 dependencies: [
 .package(url: "https://github.com/argmaxinc/argmax-oss-swift.git", from: "1.0.0"),
 .package(url: "https://github.com/Blaizzy/mlx-audio-swift.git", exact: "0.1.3"),
 .package(url: "https://github.com/huggingface/swift-transformers", from: "1.3.3"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", branch: "main"),
 .package(url: "https://github.com/ml-explore/mlx-swift-lm", exact: "3.31.4"),
 ],
 targets: [
 .executableTarget(
 name: "OpenType",
 dependencies: [
 .product(name: "WhisperKit", package: "argmax-oss-swift"),
 .product(name: "MLXAudioCore", package: "mlx-audio-swift"),
 .product(name: "MLXAudioSTT", package: "mlx-audio-swift"),
 .product(name: "Hub", package: "swift-transformers"),
 .product(name: "Tokenizers", package: "swift-transformers"),
 .product(name: "MLXLLM", package: "mlx-swift-lm"),
Expand All@@ -39,7 +42,6 @@ let package = Package(
 .copy("Resources/SettingsStyleIllustration.png"),
 .copy("Resources/SettingsIntegrationsIllustration.png"),
 .copy("Resources/SettingsAboutIllustration.png"),
 .copy("Resources/Scripts"),
 .copy("Resources/Sounds"),
 .copy("Resources/AppIcon.icns"),
 .copy("Resources/AppIconLight.icns"),
Expand Down

7 changes: 3 additions & 4 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -38,7 +38,7 @@ Three output modes are available:

| Feature | Description |
|---|---|
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, Qwen3-ASR, or MiMo-V2.5-ASR |
| **Multiple Speech Engines** | Apple Speech, WhisperKit, Doubao ASR, or Qwen3-ASR |
| **Smart Text Processing** | Local MLX Qwen2.5/Qwen3 or remote LLM infers spoken intent — contextual cleanup, "scratch that" restarts, self-correction handling, spoken punctuation, technical terms, numbers/ranges/units, and structured formatting |
| **LLM-Owned Spoken Formatting** | Spoken casing, no-space dictation, identifiers, file paths, shortcuts, emoji, Markdown tasks, dates/times, quantities, units, formulas, fractions, and digit sequences are handled by the Smart Format / Voice Command prompts instead of local hardcoded rewrite rules |
| **Voice Edit Commands** | In Voice Command mode, an LLM classifies safe structured actions for replacing, undoing, proofreading, titling, summarizing, drafting replies, making meeting notes, extracting key points/decisions/questions/risks/deadlines/owners/action items, rewriting tone, expanding, making tables/lists, or deleting the previous Utter insertion or selected text |
Expand DownExpand Up@@ -131,10 +131,9 @@ Utter supports both **OpenAI-compatible** and **Anthropic** API formats:

| Provider | Local runtime | Default model |
|---|---|---|
| Qwen3-ASR | `qwen3-asr-mlx` + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |
| MiMo-V2.5-ASR | Xiaomi's local Python runtime files + local model folders | `XiaomiMiMo/MiMo-V2.5-ASR` + `XiaomiMiMo/MiMo-Audio-Tokenizer` |
| Qwen3-ASR | Native Swift + MLX on Apple Silicon | `mlx-community/Qwen3-ASR-1.7B-bf16` |

These engines do not call hosted ASR APIs. The app downloads the selected model into the same model storage used by WhisperKit/MLX, prepares the Qwen Python runtime in an app-managed virtual environment, downloads MiMo runtime files when needed, finds an available Python 3 executable, then invokes the bundled local runner script.
Qwen3-ASR does not call a hosted ASR API. The app downloads the selected model into the same model storage used by WhisperKit and runs inference locally through native Swift and MLX.

## Project Structure

Expand Down

29 changes: 5 additions & 24 deletions
Sources/App/VoicePipeline+Models.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -25,7 +25,6 @@ extension VoicePipeline {

 func unloadLocalASR() {
 qwenSpeechEngine = nil
 mimoSpeechEngine = nil
 }

 func loadLLM() {
Expand DownExpand Up@@ -99,32 +98,14 @@ extension VoicePipeline {
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .qwen3,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.qwenASRModel),
 tokenizerPath: "",
 repoPath: ""
 ))
 let modelPath = catalog.asrModelPath(for: settings.qwenASRModel)
 if qwenSpeechEngine?.usesModel(at: modelPath) == true { return }
 let engine = QwenNativeASREngine(modelPath: modelPath)
 qwenSpeechEngine = engine
 Task { await engine.prepare() }
 case .mimo:
 let settings = appState.settings
 let catalog = ModelCatalog.shared
 guard localASRIsAvailable(settings.mimoASRModel) else {
 mimoSpeechEngine = nil
 markSpeechModelDownloadRequired(showInStatus: requestPermission)
 return
 }
 let engine = LocalASREngine(configuration: LocalASRConfiguration(
 provider: .mimo,
 pythonPath: settings.localASRPythonPath,
 modelPath: catalog.asrModelPath(for: settings.mimoASRModel),
 tokenizerPath: catalog.mimoTokenizerPath(),
 repoPath: catalog.mimoRepositoryPath()
 ))
 mimoSpeechEngine = engine
 Task { await engine.prepare() }
 appState.settings.speechEngine = .apple
 await ensureEngineLoaded(requestPermission: requestPermission)
 }
 }

Expand Down

4 changes: 1 addition & 3 deletions
Sources/App/VoicePipeline+Status.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -87,9 +87,7 @@ extension VoicePipeline {
 return error.localizedDescription
 case let error as AppleSpeechError:
 return error.localizedDescription
 case let error as LocalASRError:
 return error.localizedDescription
 case let error as LocalASRRuntimeError:
 case let error as QwenNativeASRError:
 return error.localizedDescription
 case is URLError:
 return L("error.network_request_failed")
Expand Down

5 changes: 2 additions & 3 deletions
Sources/App/VoicePipeline.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -13,8 +13,7 @@ final class VoicePipeline {
 var whisperEngine: WhisperEngine?
 var appleSpeechEngine: AppleSpeechEngine?
 var volcSpeechEngine: VolcSpeechEngine?
 var qwenSpeechEngine: LocalASREngine?
 var mimoSpeechEngine: LocalASREngine?
 var qwenSpeechEngine: QwenNativeASREngine?
 var screenOCRTask: Task<ScreenContextSnapshot, Never>?
 var screenOCRStartedAt: CFAbsoluteTime?
 var processingTask: Task<Void, Never>?
Expand All@@ -28,7 +27,7 @@ final class VoicePipeline {
 case .apple: return appleSpeechEngine
 case .volc: return volcSpeechEngine
 case .qwen3: return qwenSpeechEngine
 case .mimo: return mimoSpeechEngine
 case .mimo: return nil
 }
 }

Expand Down

15 changes: 0 additions & 15 deletions
Sources/Config/ASRDownloadError.swift

View file


Open in desktop


This file was deleted.


32 changes: 17 additions & 15 deletions
Sources/Config/AppSettings.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,6 +35,10 @@ enum SpeechEngineType: String, Codable, CaseIterable {
 case qwen3 = "qwen3"
 case mimo = "mimo"

 static var selectableCases: [SpeechEngineType] {
 allCases.filter { $0 != .mimo }
 }

 var label: String {
 switch self {
 case .whisper: return "WhisperKit"
Expand DownExpand Up@@ -288,10 +292,7 @@ final class AppSettings: ObservableObject {
 @Published var volcAppKey: String
 @Published var volcAccessKey: String
 @Published var volcResourceId: String
 @Published var localASRPythonPath: String
 @Published var qwenASRModel: String
 @Published var mimoASRRepoPath: String
 @Published var mimoASRModel: String
 @Published var preloadSpeechModelOnLaunch: Bool
 @Published var preloadFormattingModelOnLaunch: Bool
 @Published var modelStoragePath: String
Expand All@@ -315,9 +316,7 @@ final class AppSettings: ObservableObject {
 case useRemoteLLM, remoteProvider, remoteAPIKey, remoteBaseURL, remoteModel
 case menuBarIcon, appIconAppearance
 case volcAppKey, volcAccessKey, volcResourceId
 case localASRPythonPath
 case qwenASRModel, qwenASRModelPath
 case mimoASRRepoPath, mimoASRModel, mimoASRModelPath, mimoASRTokenizerPath
 case preloadSpeechModelOnLaunch, preloadFormattingModelOnLaunch
 case modelStoragePath, localWhisperModelPaths, localLLMModelPaths
 case developerInterfaceEnabled, developerHTTPPort, developerHTTPToken
Expand All@@ -342,9 +341,20 @@ final class AppSettings: ObservableObject {
 ?? .longPress
 tapInterval = ud.double(forKey: Key.tapInterval.rawValue).nonZero ?? 0.4
 let savedEngine = ud.string(forKey: Key.speechEngine.rawValue) ?? ""
speechEngine = SpeechEngineType(rawValue: savedEngine)
let loadedSpeechEngine = SpeechEngineType(rawValue: savedEngine)
 ?? (savedEngine.contains("Whisper") || savedEngine.contains("whisper") ? .whisper : nil)
 ?? .apple
 speechEngine = loadedSpeechEngine == .mimo ? .apple : loadedSpeechEngine
 if loadedSpeechEngine == .mimo {
 ud.set(SpeechEngineType.apple.rawValue, forKey: Key.speechEngine.rawValue)
 }
 [
 "localASRPythonPath",
 "mimoASRRepoPath",
 "mimoASRModel",
 "mimoASRModelPath",
 "mimoASRTokenizerPath",
 ].forEach(ud.removeObject(forKey:))
 whisperModel = ud.string(forKey: Key.whisperModel.rawValue) ?? "large-v3"
 llmModel = ud.string(forKey: Key.llmModel.rawValue) ?? Self.defaultLLMModelID
 microphoneID = ud.string(forKey: Key.microphoneID.rawValue)
Expand DownExpand Up@@ -387,14 +397,9 @@ final class AppSettings: ObservableObject {
 volcAppKey = ud.string(forKey: Key.volcAppKey.rawValue) ?? ""
 volcAccessKey = ud.string(forKey: Key.volcAccessKey.rawValue) ?? ""
 volcResourceId = ud.string(forKey: Key.volcResourceId.rawValue) ?? VolcASRModel.recommended.rawValue
 localASRPythonPath = ud.string(forKey: Key.localASRPythonPath.rawValue) ?? LocalASRConfiguration.defaultPythonPath
 qwenASRModel = ud.string(forKey: Key.qwenASRModel.rawValue)
 ?? ud.string(forKey: Key.qwenASRModelPath.rawValue)
 ?? LocalASRConfiguration.qwen3DefaultModel
 mimoASRRepoPath = ud.string(forKey: Key.mimoASRRepoPath.rawValue) ?? ""
 mimoASRModel = ud.string(forKey: Key.mimoASRModel.rawValue)
 ?? ud.string(forKey: Key.mimoASRModelPath.rawValue)
 ?? LocalASRConfiguration.mimoDefaultModel
 ?? QwenASRModel.defaultID
 preloadSpeechModelOnLaunch = ud.object(forKey: Key.preloadSpeechModelOnLaunch.rawValue) as? Bool ?? true
 preloadFormattingModelOnLaunch = ud.object(forKey: Key.preloadFormattingModelOnLaunch.rawValue) as? Bool ?? true
 modelStoragePath = ud.string(forKey: Key.modelStoragePath.rawValue) ?? ModelStorage.defaultRoot.path
Expand DownExpand Up@@ -456,10 +461,7 @@ final class AppSettings: ObservableObject {
 $volcAppKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAppKey.rawValue) }.store(in: &cancellables)
 $volcAccessKey.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcAccessKey.rawValue) }.store(in: &cancellables)
 $volcResourceId.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.volcResourceId.rawValue) }.store(in: &cancellables)
 $localASRPythonPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.localASRPythonPath.rawValue) }.store(in: &cancellables)
 $qwenASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.qwenASRModel.rawValue) }.store(in: &cancellables)
 $mimoASRRepoPath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRRepoPath.rawValue) }.store(in: &cancellables)
 $mimoASRModel.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.mimoASRModel.rawValue) }.store(in: &cancellables)
 $preloadSpeechModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadSpeechModelOnLaunch.rawValue) }.store(in: &cancellables)
 $preloadFormattingModelOnLaunch.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.preloadFormattingModelOnLaunch.rawValue) }.store(in: &cancellables)
 $modelStoragePath.dropFirst().sink { [defaults] in defaults.set($0, forKey: Key.modelStoragePath.rawValue) }.store(in: &cancellables)
Expand Down

5 changes: 1 addition & 4 deletions
Sources/Config/ModelCatalog.swift

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -129,10 +129,7 @@ final class ModelCatalog: ObservableObject {
 ModelEntry(id: $0.id, displayName: $0.displayName, hint: $0.hint, family: nil)
 }
 if !asrModels.contains(where: { $0.id == settings.qwenASRModel }) {
 settings.qwenASRModel = LocalASRConfiguration.qwen3DefaultModel
 }
 if !asrModels.contains(where: { $0.id == settings.mimoASRModel }) {
 settings.mimoASRModel = LocalASRConfiguration.mimoDefaultModel
 settings.qwenASRModel = QwenASRModel.defaultID
 }
 refreshStatus()
 }
Expand Down
Loading
Loading