Voice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.
JavaScript aianthropiccross-platformgeminigroqlinuxmacosnvidiaopen-sourceopenaiparakeetspeech-to-texttranscribewhisperwindows
fix: surface TLS/certificate errors in model download UI
Gabriel Stein1f4e7c4d34d6
diff --git a/src/helpers/downloadUtils.js b/src/helpers/downloadUtils.jsindex e249100da..971c57b54 100644--- a/src/helpers/downloadUtils.js+++ b/src/helpers/downloadUtils.js@@ -27,8 +27,25 @@ const RETRYABLE_CODES = new Set(["ERR_DOWNLOAD_INCOMPLETE",]);+const TLS_ERROR_CODES = new Set([+ "UNABLE_TO_VERIFY_LEAF_SIGNATURE",+ "DEPTH_ZERO_SELF_SIGNED_CERT",+ "SELF_SIGNED_CERT_IN_CHAIN",+ "CERT_HAS_EXPIRED",+ "ERR_TLS_CERT_ALTNAME_INVALID",+ "CERT_UNTRUSTED",+]);++function isTlsError(error) {+ return (+ TLS_ERROR_CODES.has(error.code) ||+ (error.message &&+ error.message.includes("unable to get local issuer certificate"))+ );+}+function isRetryable(error) {- if (error.isAbort || error.isHttpError) return false;+ if (error.isAbort || error.isHttpError || isTlsError(error)) return false;return RETRYABLE_CODES.has(error.code);}@@ -219,6 +236,13 @@ function downloadAttempt(url, tempPath, options) {cleanup();if (signal?.aborted) {reject(Object.assign(new Error("Download cancelled"), { isAbort: true }));+ } else if (isTlsError(err)) {+ reject(+ Object.assign(+ new Error(`Certificate error: ${err.message}`),+ { code: "TLS_ERROR", isTlsError: true },+ ),+ );} else {reject(err);}@@ -321,6 +345,11 @@ async function downloadFile(url, destPath, options = {}) {}if (!isRetryable(error) || attempt >= maxRetries) {+ debugLogger.error("Download failed", {+ url,+ error: error.message,+ code: error.code,+ });await fsPromises.unlink(tempPath).catch(() => {});throw error;}diff --git a/src/hooks/useModelDownload.ts b/src/hooks/useModelDownload.tsindex c644765cc..9e4650eea 100644--- a/src/hooks/useModelDownload.ts+++ b/src/hooks/useModelDownload.ts@@ -41,6 +41,8 @@ export function formatETA(seconds: number): string {function getDownloadErrorMessage(t: TFunction, error: string, code?: string): string {if (code === "EXTRACTION_FAILED" || error.includes("installation failed"))return t("hooks.modelDownload.errors.extractionFailed");+ if (code === "TLS_ERROR" || error.includes("certificate") || error.includes("issuer"))+ return t("hooks.modelDownload.errors.tlsError");if (code === "ETIMEDOUT" || error.includes("timeout") || error.includes("stalled"))return t("hooks.modelDownload.errors.timeout");if (code === "ENOTFOUND" || error.includes("ENOTFOUND"))diff --git a/src/locales/de/translation.json b/src/locales/de/translation.jsonindex c4ad4f48b..4cf503a93 100644--- a/src/locales/de/translation.json+++ b/src/locales/de/translation.json@@ -391,8 +391,9 @@"rateLimited": "Download-Server begrenzt Anfragen. Bitte warten Sie einige Minuten und versuchen Sie es erneut.","server": "Serverfehler ({{error}}). Bitte versuchen Sie es später erneut.","generic": "Download fehlgeschlagen: {{error}}",- "extractionFailed": "Modell heruntergeladen, aber Installation fehlgeschlagen. Klicken Sie auf „Herunterladen“, um die Installation ohne erneuten Download zu wiederholen.",- "unknown": "Unbekannter Fehler"+ “extractionFailed”: “Modell heruntergeladen, aber Installation fehlgeschlagen. Klicken Sie auf „Herunterladen”, um die Installation ohne erneuten Download zu wiederholen.”,+ “tlsError”: “Zertifikatsfehler — Ihr Netzwerk verwendet möglicherweise SSL-Inspektion, die Downloads blockiert. Versuchen Sie es über ein anderes Netzwerk.”,+ “unknown”: “Unbekannter Fehler”},"downloadFailed": {"title": "Download fehlgeschlagen"diff --git a/src/locales/en/translation.json b/src/locales/en/translation.jsonindex 054748775..5013ff68e 100644--- a/src/locales/en/translation.json+++ b/src/locales/en/translation.json@@ -392,6 +392,7 @@"server": "Server error ({{error}}). Please try again later.","generic": "Download failed: {{error}}","extractionFailed": "Model downloaded but installation failed. Click download to retry installation without re-downloading.",+ "tlsError": "Certificate error — your network may use SSL inspection that blocks downloads. Try downloading from a different network.","unknown": "Unknown error"},"downloadFailed": {diff --git a/src/locales/es/translation.json b/src/locales/es/translation.jsonindex 1497a285a..1f3e79c7e 100644--- a/src/locales/es/translation.json+++ b/src/locales/es/translation.json@@ -392,6 +392,7 @@"server": "Error del servidor ({{error}}). Inténtalo más tarde.","generic": "Falló la descarga: {{error}}","extractionFailed": "Modelo descargado, pero la instalación falló. Haz clic en descargar para reintentar la instalación sin volver a descargar.",+ "tlsError": "Error de certificado — tu red puede usar inspección SSL que bloquea las descargas. Intenta descargar desde otra red.","unknown": "Error desconocido"},"downloadFailed": {diff --git a/src/locales/fr/translation.json b/src/locales/fr/translation.jsonindex 3e3360c0a..50675c405 100644--- a/src/locales/fr/translation.json+++ b/src/locales/fr/translation.json@@ -392,6 +392,7 @@"server": "Erreur serveur ({{error}}). Réessayez plus tard.","generic": "Échec du téléchargement : {{error}}","extractionFailed": "Modèle téléchargé, mais l'installation a échoué. Cliquez sur télécharger pour relancer l'installation sans retélécharger.",+ "tlsError": "Erreur de certificat — votre réseau utilise peut-être une inspection SSL qui bloque les téléchargements. Essayez depuis un autre réseau.","unknown": "Erreur inconnue"},"downloadFailed": {diff --git a/src/locales/it/translation.json b/src/locales/it/translation.jsonindex a2f55088f..40c0020db 100644--- a/src/locales/it/translation.json+++ b/src/locales/it/translation.json@@ -392,6 +392,7 @@"server": "Errore server ({{error}}). Riprova più tardi.","generic": "Download non riuscito: {{error}}","extractionFailed": "Modello scaricato, ma l'installazione non è riuscita. Clicca su scarica per ritentare l'installazione senza riscaricare.",+ "tlsError": "Errore di certificato — la tua rete potrebbe usare l'ispezione SSL che blocca i download. Prova a scaricare da un'altra rete.","unknown": "Errore sconosciuto"},"downloadFailed": {diff --git a/src/locales/ja/translation.json b/src/locales/ja/translation.jsonindex 1cc1119a9..03fa611a2 100644--- a/src/locales/ja/translation.json+++ b/src/locales/ja/translation.json@@ -392,6 +392,7 @@"server": "サーバーエラー({{error}})。後でもう一度お試しください。","generic": "ダウンロードに失敗しました: {{error}}","extractionFailed": "モデルのダウンロードは完了しましたが、インストールに失敗しました。ダウンロードをクリックして再ダウンロードなしでインストールを再試行してください。",+ "tlsError": "証明書エラー — ネットワークのSSL検査がダウンロードをブロックしている可能性があります。別のネットワークからお試しください。","unknown": "不明なエラー"},"downloadFailed": {diff --git a/src/locales/pt/translation.json b/src/locales/pt/translation.jsonindex fe7032a91..51baf97c0 100644--- a/src/locales/pt/translation.json+++ b/src/locales/pt/translation.json@@ -364,6 +364,7 @@"server": "Erro do servidor ({{error}}). Tente mais tarde.","generic": "Falha no download: {{error}}","extractionFailed": "Modelo baixado, mas a instalação falhou. Clique em baixar para tentar a instalação novamente sem precisar baixar de novo.",+ "tlsError": "Erro de certificado — sua rede pode usar inspeção SSL que bloqueia downloads. Tente baixar de outra rede.","unknown": "Erro desconhecido"},"downloadFailed": {diff --git a/src/locales/ru/translation.json b/src/locales/ru/translation.jsonindex 059c4b2eb..54cf43dd4 100644--- a/src/locales/ru/translation.json+++ b/src/locales/ru/translation.json@@ -392,6 +392,7 @@"server": "Ошибка сервера ({{error}}). Попробуйте позже.","generic": "Ошибка загрузки: {{error}}","extractionFailed": "Модель скачана, но установка не удалась. Нажмите «Скачать» для повторной установки без повторной загрузки.",+ "tlsError": "Ошибка сертификата — ваша сеть может использовать SSL-инспекцию, блокирующую загрузки. Попробуйте скачать из другой сети.","unknown": "Неизвестная ошибка"},"downloadFailed": {diff --git a/src/locales/zh-CN/translation.json b/src/locales/zh-CN/translation.jsonindex 3e01289c7..dec64125c 100644--- a/src/locales/zh-CN/translation.json+++ b/src/locales/zh-CN/translation.json@@ -392,6 +392,7 @@"server": "服务器错误({{error}}),请稍后重试。","generic": "下载失败:{{error}}","extractionFailed": "模型已下载但安装失败。点击下载以重新安装,无需重新下载。",+ "tlsError": "证书错误 — 您的网络可能使用了阻止下载的SSL检查。请尝试从其他网络下载。","unknown": "未知错误"},"downloadFailed": {diff --git a/src/locales/zh-TW/translation.json b/src/locales/zh-TW/translation.jsonindex 514887d65..c7d12bd78 100644--- a/src/locales/zh-TW/translation.json+++ b/src/locales/zh-TW/translation.json@@ -392,6 +392,7 @@"server": "伺服器錯誤({{error}})。請稍後再試。","generic": "下載失敗:{{error}}","extractionFailed": "模型已下載,但安裝失敗。點擊下載可重試安裝,無需重新下載。",+ "tlsError": "憑證錯誤 — 您的網路可能使用了阻擋下載的SSL檢查。請嘗試從其他網路下載。","unknown": "未知錯誤"},"downloadFailed": {