Skip to content

Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.

refactor(orukeet): drop the q8 suffix from the model id, use registry names for upload labels, and shrink the Oruk mark (#2114)

Gabriel Stein5e5d5571bdda
diff --git a/src/assets/icons/providers/oruk.webp b/src/assets/icons/providers/oruk.webp
index 31a71c947..032c30c83 100644
Binary files a/src/assets/icons/providers/oruk.webp and b/src/assets/icons/providers/oruk.webp differ
diff --git a/src/components/TranscriptionModelPicker.tsx b/src/components/TranscriptionModelPicker.tsx
index 828f028bf..0e83b9f4f 100644
--- a/src/components/TranscriptionModelPicker.tsx
+++ b/src/components/TranscriptionModelPicker.tsx
@@ -1,9 +1,3 @@
-import {
- LOCAL_ASR_ORGANIZATIONS,
- getASRModelOrganization,
- getSelectedASROrganization,
- usesParakeetManager,
-} from "../helpers/localASROrganization";
import { useState, useEffect, useCallback, useMemo, useRef } from "react";
import { useTranslation } from "react-i18next";
import { Button } from "./ui/button";
@@ -40,6 +34,12 @@ import {
type TranscriptionPolicyContext,
} from "../stores/policyRules";
import { usePolicySnapshot } from "../hooks/usePolicy";
+import {
+ LOCAL_ASR_ORGANIZATIONS,
+ getASRModelOrganization,
+ getSelectedASROrganization,
+ usesParakeetManager,
+} from "../helpers/localASROrganization";
import { STREAMING_ONLY_PROVIDERS } from "../helpers/transcriptionRoute";
import { getRemoteProviderIcon } from "../utils/providerIcons";
import { createExternalLinkHandler } from "../utils/externalLinks";
diff --git a/src/components/notes/UploadAudioView.tsx b/src/components/notes/UploadAudioView.tsx
index 35d91d326..964488796 100644
--- a/src/components/notes/UploadAudioView.tsx
+++ b/src/components/notes/UploadAudioView.tsx
@@ -495,12 +495,8 @@ export default function UploadAudioView({ onNoteCreated, onOpenSettings }: Uploa
const getActiveModelLabel = (): string => {
if (isOpenWhisprCloud) return t("notes.upload.openwhisprCloud");
if (useLocalWhisper) {
- if (localTranscriptionProvider === "nvidia") {
- const model = getParakeetModelInfo(parakeetModel);
- return model?.organization?.id === "oruk"
- ? model.name
- : `Parakeet · ${parakeetModel || "default"}`;
- }
+ if (localTranscriptionProvider === "nvidia")
+ return getParakeetModelInfo(parakeetModel)?.name ?? parakeetModel;
if (localTranscriptionProvider === "cohere") return `Cohere · ${cohereModel || "default"}`;
return `Whisper · ${whisperModel || "base"}`;
}
diff --git a/src/components/onboarding/BackgroundModelDownloadTray.tsx b/src/components/onboarding/BackgroundModelDownloadTray.tsx
index f3402e6d6..5ed90b1d1 100644
--- a/src/components/onboarding/BackgroundModelDownloadTray.tsx
+++ b/src/components/onboarding/BackgroundModelDownloadTray.tsx
@@ -1,4 +1,3 @@
-import { getASRModelOrganization } from "../../helpers/localASROrganization";
import { useCallback, useEffect, useMemo, useRef, useState, type CSSProperties } from "react";
import { useTranslation } from "react-i18next";
import { ProviderIcon } from "../ui/ProviderIcon";
@@ -8,6 +7,7 @@ import {
getWhisperModelInfo,
modelRegistry,
} from "../../models/ModelRegistry";
+import { getASRModelOrganization } from "../../helpers/localASROrganization";
import { useSettingsStore } from "../../stores/settingsStore";
import {
consumePendingLocalModel,
diff --git a/src/components/onboarding/ProviderSetupStep.tsx b/src/components/onboarding/ProviderSetupStep.tsx
index ae57eb4d0..a1c095bb6 100644
--- a/src/components/onboarding/ProviderSetupStep.tsx
+++ b/src/components/onboarding/ProviderSetupStep.tsx
@@ -1,9 +1,3 @@
-import {
- LOCAL_ASR_ORGANIZATIONS,
- getASRModelOrganization,
- getSelectedASROrganization,
- usesParakeetManager,
-} from "../../helpers/localASROrganization";
import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
import { AudioLines, Check, CircleCheck, Download, MousePointer2 } from "lucide-react";
import { useTranslation } from "react-i18next";
@@ -29,6 +23,12 @@ import {
type CloudProviderData,
type TranscriptionProviderData,
} from "../../models/ModelRegistry";
+import {
+ LOCAL_ASR_ORGANIZATIONS,
+ getASRModelOrganization,
+ getSelectedASROrganization,
+ usesParakeetManager,
+} from "../../helpers/localASROrganization";
import { pickDefaultModelId } from "../../models/providerDefaultModel";
import {
RESUME_DRAFT_PERSIST_DELAY_MS,
diff --git a/src/components/onboarding/RequiredModelDownloadStep.tsx b/src/components/onboarding/RequiredModelDownloadStep.tsx
index 7923a9cd1..85a077157 100644
--- a/src/components/onboarding/RequiredModelDownloadStep.tsx
+++ b/src/components/onboarding/RequiredModelDownloadStep.tsx
@@ -1,10 +1,10 @@
-import { getASRModelOrganization } from "../../helpers/localASROrganization";
import { useCallback, useEffect, useMemo, useRef } from "react";
import { AlertCircle, Check } from "lucide-react";
import { useTranslation } from "react-i18next";
import { Button } from "../ui/button";
import { ProviderIcon } from "../ui/ProviderIcon";
import { useModelDownload } from "../../hooks/useModelDownload";
+import { getASRModelOrganization } from "../../helpers/localASROrganization";
import { getParakeetModels, getWhisperModels } from "../../models/ModelRegistry";
import { SETUP_CARD_CLASS } from "./ProviderSetupStep";
diff --git a/src/models/modelRegistryData.json b/src/models/modelRegistryData.json
index a67f4d11f..8694b1125 100644
--- a/src/models/modelRegistryData.json
+++ b/src/models/modelRegistryData.json
@@ -117,7 +117,7 @@
"extractDir": "sherpa-onnx-cohere-transcribe-14-lang-int8-2026-04-01",
"descriptionKey": "models.descriptions.cohere.cohere_transcribe_03_2026"
},
- "orukeet-v0.1.0-q8": {
+ "orukeet-v0.1.0": {
"name": "Orukeet",
"description": "Multilingual Parakeet fine-tune with frozen Gabor kernels",
"descriptionKey": "models.descriptions.parakeet.orukeet",
diff --git a/test/components/localModelSetupStep.test.js b/test/components/localModelSetupStep.test.js
index f30a5ac4e..f578ec710 100644
--- a/test/components/localModelSetupStep.test.js
+++ b/test/components/localModelSetupStep.test.js
@@ -423,7 +423,7 @@ test("choosing a local model records it in the resume draft", async (t) => {
});
test("Oruk installs and activates Orukeet through the existing parakeet download flow", async (t) => {
- const modelId = "orukeet-v0.1.0-q8";
+ const modelId = "orukeet-v0.1.0";
const setup = await createSetupHarness(t);
await setup.chooseProvider("oruk");
assert.match(textContent(setup.row(modelId)), /common\.recommended/);
diff --git a/test/components/orukeetOrganization.test.js b/test/components/orukeetOrganization.test.js
index 9cd6405db..c90114c06 100644
--- a/test/components/orukeetOrganization.test.js
+++ b/test/components/orukeetOrganization.test.js
@@ -38,7 +38,7 @@ test("onboarding restores an Oruk draft without mixing NVIDIA models", async (t)
vite,
React.createElement(LocalModelSetupStep, {
stepId: "local-dictation",
- resumeState: { provider: "oruk", modelId: "orukeet-v0.1.0-q8" },
+ resumeState: { provider: "oruk", modelId: "orukeet-v0.1.0" },
onReadinessChange: noop,
onProceed: noop,
onSkip: noop,
@@ -58,7 +58,7 @@ test("all three model pickers restore the Oruk tab from the persisted Orukeet ch
React.createElement(Picker, {
transcriptionContext,
selectedLocalProvider: "nvidia",
- selectedLocalModel: "orukeet-v0.1.0-q8",
+ selectedLocalModel: "orukeet-v0.1.0",
useLocalWhisper: true,
onLocalModelSelect: noop,
onModeChange: noop,
@@ -117,7 +117,7 @@ test("Oruk's model-picker tab follows the same unsupported-macOS fallback as Par
function Harness() {
tree = Picker({
selectedLocalProvider: "nvidia",
- selectedLocalModel: "orukeet-v0.1.0-q8",
+ selectedLocalModel: "orukeet-v0.1.0",
useLocalWhisper: true,
onLocalModelSelect: noop,
onLocalProviderSelect: (provider) => selectedProviders.push(provider),
diff --git a/test/helpers/audioManagerPreviewFinalization.test.js b/test/helpers/audioManagerPreviewFinalization.test.js
index b553c5952..e70966d7a 100644
--- a/test/helpers/audioManagerPreviewFinalization.test.js
+++ b/test/helpers/audioManagerPreviewFinalization.test.js
@@ -24,7 +24,7 @@ for (const streamingCommit of [false, true]) {
window.electronAPI.transcribeLocalParakeet = async (buffer, options) => {
calls.push("final-decode");
assert.deepEqual(new Uint8Array(buffer), bytes);
- assert.equal(options.model, "orukeet-v0.1.0-q8");
+ assert.equal(options.model, "orukeet-v0.1.0");
return { success: true, text: "complete recording" };
};
let finalResult;
@@ -43,7 +43,7 @@ for (const streamingCommit of [false, true]) {
async processAudio(blob, metadata) {
assert.strictEqual(blob, recording);
assert.equal(metadata.streamedText, undefined);
- finalResult = await this.processWithLocalParakeet(blob, "orukeet-v0.1.0-q8", metadata);
+ finalResult = await this.processWithLocalParakeet(blob, "orukeet-v0.1.0", metadata);
},
});
diff --git a/test/helpers/dictationPreviewStop.test.js b/test/helpers/dictationPreviewStop.test.js
index c47df9f65..b4a5f83a8 100644
--- a/test/helpers/dictationPreviewStop.test.js
+++ b/test/helpers/dictationPreviewStop.test.js
@@ -108,7 +108,7 @@ function scenario(t, { decode, stream, online = false } = {}) {
})
);
const invoke = (channel, ...args) => handlers.get(channel)({}, ...args);
- const start = (model = "orukeet-v0.1.0-q8") =>
+ const start = (model = "orukeet-v0.1.0") =>
invoke("start-dictation-preview", {
provider: "nvidia",
model,
@@ -143,7 +143,7 @@ test("offline stop skips pending preview audio while final audio still reaches t
assert.equal(s.calls.held.length, 1);
const finalAudio = Buffer.from("the complete MediaRecorder recording, including pre-roll");
const result = await s.invoke("transcribe-local-parakeet", finalAudio, {
- model: "orukeet-v0.1.0-q8",
+ model: "orukeet-v0.1.0",
language: "en",
});
assert.equal(result.text, "recognized");
@@ -188,7 +188,7 @@ test("a cancelled preview cannot append or release the next session's in-flight
assert.deepEqual(s.calls.appended, ["current session"]);
assert.deepEqual(
s.calls.decode.map(({ options }) => options.model),
- ["orukeet-v0.1.0-q8", "parakeet-tdt-0.6b-v3"]
+ ["orukeet-v0.1.0", "parakeet-tdt-0.6b-v3"]
);
});
diff --git a/test/helpers/parakeetModelRegistry.test.js b/test/helpers/parakeetModelRegistry.test.js
index b520d2f74..e144e7db1 100644
--- a/test/helpers/parakeetModelRegistry.test.js
+++ b/test/helpers/parakeetModelRegistry.test.js
@@ -96,7 +96,7 @@ test("cohere language resolution maps app languages to supported codes", () => {
test("only verified offline NeMo models skip sherpa metadata detection", () => {
assert.equal(getSherpaModelType("parakeet-tdt-0.6b-v3"), "nemo_transducer");
- assert.equal(getSherpaModelType("orukeet-v0.1.0-q8"), "nemo_transducer");
+ assert.equal(getSherpaModelType("orukeet-v0.1.0"), "nemo_transducer");
assert.equal(getSherpaModelType("parakeet-unified-en-0.6b"), null);
assert.equal(getSherpaModelType("cohere-transcribe-03-2026"), null);
assert.equal(getSherpaModelType("nemotron-speech-streaming-en-0.6b"), null);
@@ -110,7 +110,7 @@ test("sherpa provider check covers nvidia and cohere only", () => {
});
test("Orukeet uses the existing Parakeet TDT v3 runtime and model layout", () => {
- const id = "orukeet-v0.1.0-q8";
+ const id = "orukeet-v0.1.0";
const model = modelData.parakeetModels[id];
const stock = modelData.parakeetModels["parakeet-tdt-0.6b-v3"];
assert.equal(model.name, "Orukeet");
diff --git a/test/helpers/parakeetWsStartup.test.js b/test/helpers/parakeetWsStartup.test.js
index 1c1b8950f..d02b51bd8 100644
--- a/test/helpers/parakeetWsStartup.test.js
+++ b/test/helpers/parakeetWsStartup.test.js
@@ -61,7 +61,7 @@ async function startupArgs(modelName, runtime = "offline", language = null, regi
return calls[0];
}
-for (const modelName of ["parakeet-tdt-0.6b-v3", "orukeet-v0.1.0-q8"]) {
+for (const modelName of ["parakeet-tdt-0.6b-v3", "orukeet-v0.1.0"]) {
test(`${modelName} starts the offline server with the NeMo decoder hint`, async () => {
const { binary, args } = await startupArgs(modelName);
assert.equal(binary, "sherpa-offline");
@@ -96,7 +96,7 @@ test("Cohere keeps its language-specific startup arguments", async () => {
});
test("online startup preserves its scheduling flags and omits offline decoder hints", async () => {
- for (const modelName of ["nemotron-speech-streaming-en-0.6b", "orukeet-v0.1.0-q8"]) {
+ for (const modelName of ["nemotron-speech-streaming-en-0.6b", "orukeet-v0.1.0"]) {
const { binary, args } = await startupArgs(modelName, "online");
assert.equal(binary, "sherpa-online");
assert.ok(!args.some((arg) => arg.startsWith("--model-type=")));
diff --git a/test/helpers/transcriptionModelDownloadStatus.test.js b/test/helpers/transcriptionModelDownloadStatus.test.js
index 7f8c1b2de..6230bf0c6 100644
--- a/test/helpers/transcriptionModelDownloadStatus.test.js
+++ b/test/helpers/transcriptionModelDownloadStatus.test.js
@@ -320,10 +320,10 @@ test("Parakeet refuses cancellation after installation starts", async () => {
assert.equal(manager.currentDownloadProcess, active);
});
-test("an old Orukeet GGUF install requires the sherpa ONNX package", async (t) => {
+test("an Orukeet directory without the sherpa ONNX files is not downloaded", async (t) => {
const directory = await fs.mkdtemp(path.join(os.tmpdir(), "openwhispr-orukeet-layout-"));
t.after(() => fs.rm(directory, { recursive: true, force: true }));
- const modelName = "orukeet-v0.1.0-q8";
+ const modelName = "orukeet-v0.1.0";
const modelDirectory = path.join(directory, modelName);
await fs.mkdir(modelDirectory);
await fs.writeFile(path.join(modelDirectory, "orukeet-r3-93ce19c6-q8.gguf"), "old model");
@@ -342,7 +342,7 @@ test("an old Orukeet GGUF install requires the sherpa ONNX package", async (t) =
test("Orukeet inherits the packaged sherpa macOS floor before download or startup", async (t) => {
stubMacosVersion(t, "14.8");
const manager = new ParakeetManager();
- const modelName = "orukeet-v0.1.0-q8";
+ const modelName = "orukeet-v0.1.0";
manager.getModelsDir = () => {
throw new Error("unexpected filesystem access");
};