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
// Require a real dotted-quad before applying IPv4 private-range checks so
// public DNS names like "127.example.com" / "10.example.com" cannot bypass
// the HTTPS requirement via string-prefix matching.
function parseIPv4Literal(hostname: string): number[] | null {
const parts = hostname.split(".");
if (parts.length !== 4) return null;
const octets: number[] = [];
for (const part of parts) {
// Reject empty labels, leading zeros ("01"), and non-decimal forms.
if (!/^(0|[1-9]\d{0,2})$/.test(part)) return null;
const value = Number(part);
if (value > 255) return null;
octets.push(value);
}
return octets;
}
function isPrivateHost(hostname: string): boolean {
const h = hostname.toLowerCase().replace(/^\[|\]$/g, "");
if (h === "localhost" || h === "0.0.0.0") return true;
if (h === "::1") return true;
const ipv4 = parseIPv4Literal(h);
if (ipv4) {
const [a, b] = ipv4;
if (a === 127) return true;
if (a === 10) return true;
if (a === 192 && b === 168) return true;
if (a === 172 && b >= 16 && b <= 31) return true;
// RFC 6598 CGNAT (Tailscale): 100.64.0.0/10
if (a === 100 && b >= 64 && b <= 127) return true;
if (a === 169 && b === 254) return true;
}
const isIPv6 = h.includes(":");
// Link-local is fe80::/10 (fe80–febf), not only the fe80 hextet. Same rule as
// isPrivateIp in urlAudioDownloader.js. Unique local is fc00::/7 (fc/fd).
if (isIPv6 && (/^fe[89ab]/.test(h) || h.startsWith("fc") || h.startsWith("fd"))) return true;
if (h.endsWith(".local")) return true;
// Tailscale MagicDNS — resolves to CGNAT (100.64/10) addresses reachable
// only inside the user's own tailnet.
if (h.endsWith(".ts.net")) return true;
return false;
}
export function isSecureHttpEndpoint(url: string): boolean {
try {
const parsed = new URL(url);
return (
parsed.protocol === "https:" ||
(parsed.protocol === "http:" && isPrivateHost(parsed.hostname))
);
} catch {
return false;
}
}
/**
* Scheme-less input is read as https: the connection test does the same, so a commit
* that stores this value stores the URL it validated, and the runtime's
* isSecureHttpEndpoint gate never sees a bare host.
*/
export function withHttpsScheme(url: string): string {
const trimmed = url.trim();
return !trimmed || trimmed.includes("://") ? trimmed : `https://${trimmed}`;
}
// A bare "host/path" base still matches, and a subdomain counts as the same provider.
export function matchesHost(url: string | null | undefined, host: string): boolean {
if (!url) return false;
try {
const hostname = new URL(withHttpsScheme(url)).hostname.toLowerCase();
return hostname === host || hostname.endsWith(`.${host}`);
} catch {
return false;
}
}
const AZURE_HOST_SUFFIXES = [
".openai.azure.com",
".cognitiveservices.azure.com",
".services.ai.azure.com",
];
// API version that supports the gpt-4o-transcribe / gpt-4o-mini-transcribe audio
// models (and remains compatible with whisper-1). Used when the user doesn't
// pin their own api-version in the endpoint URL.
export const DEFAULT_AZURE_TRANSCRIPTION_API_VERSION = "2025-03-01-preview";
export function isAzureOpenAIEndpoint(url: string): boolean {
try {
const host = new URL(url).hostname.toLowerCase();
return AZURE_HOST_SUFFIXES.some((suffix) => host.endsWith(suffix));
} catch {
return false;
}
}
// Azure OpenAI doesn't expose the plain OpenAI `{base}/audio/transcriptions`
// shape — it routes by deployment in the path and requires an `api-version`
// query string. Given the user's resource endpoint and the deployment name
// (the "model" field), build the deployment-style URL Azure actually expects.
//
// If the user already pasted a full `.../audio/transcriptions` URL, it's
// respected as-is so they can pin a custom path / api-version.
export function buildAzureTranscriptionUrl(
base: string,
deployment: string,
apiVersion?: string
): string | null {
try {
const parsed = new URL(base);
const path = parsed.pathname.replace(/\/+$/, "");
if (/\/audio\/(transcriptions|translations)$/i.test(path)) {
return parsed.toString();
}
const name = (deployment || "").trim();
if (!name) return null;
const version =
parsed.searchParams.get("api-version") ||
(apiVersion || "").trim() ||
DEFAULT_AZURE_TRANSCRIPTION_API_VERSION;
return `${parsed.origin}/openai/deployments/${encodeURIComponent(
name
)}/audio/transcriptions?api-version=${encodeURIComponent(version)}`;
} catch {
return null;
}
}
// Workload-identity (managed) Azure STT. Only the deployments route serves a
// transcription deployment: `/openai/v1/audio/transcriptions?api-version=preview`
// answers 404 DeploymentNotFound, and the deployments route rejects the
// v1-surface aliases ("v1", "preview") outright — so those aliases are
// translated to the dated version that is known to serve audio. Dated versions
// pass through unchanged.
export function buildManagedAzureTranscriptionUrl(
endpoint: string,
deployment: string,
apiVersion: string
): string | null {
let origin: string;
try {
origin = new URL(endpoint).origin;
} catch {
return null;
}
const version =
apiVersion === "v1" || apiVersion === "preview"
? DEFAULT_AZURE_TRANSCRIPTION_API_VERSION
: apiVersion;
return buildAzureTranscriptionUrl(origin, deployment, version);
}