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
const fs = require("fs");
const net = require("net");
const os = require("os");
const path = require("path");
const { killProcessGroup } = require("./process");
const GRACEFUL_STOP_TIMEOUT_MS = 5000;
function tryBind(port, host) {
return new Promise((resolve) => {
const s = net.createServer();
// A host whose address family is absent (e.g. IPv6 disabled) can't conflict on the port.
s.once("error", (err) => resolve(err.code === "EADDRNOTAVAIL" || err.code === "EAFNOSUPPORT"));
s.once("listening", () => s.close(() => resolve(true)));
s.listen(port, host);
});
}
async function isPortAvailable(port) {
return (
(await tryBind(port, "0.0.0.0")) &&
(await tryBind(port, "::")) &&
(await tryBind(port, "127.0.0.1"))
);
}
async function findAvailablePort(rangeStart, rangeEnd) {
for (let port = rangeStart; port <= rangeEnd; port++) {
if (await isPortAvailable(port)) return port;
}
throw new Error(`No available ports in range ${rangeStart}-${rangeEnd}`);
}
function resolveBinaryPath(binaryName) {
const candidates = [];
if (process.resourcesPath) {
candidates.push(path.join(process.resourcesPath, "bin", binaryName));
}
const projectBinDir = path.resolve(__dirname, "..", "..", "resources", "bin");
candidates.push(path.join(projectBinDir, binaryName));
for (const candidate of candidates) {
if (fs.existsSync(candidate)) {
try {
fs.statSync(candidate);
return candidate;
} catch {
// Can't access binary
}
}
}
return null;
}
async function gracefulStopProcess(proc) {
killProcessGroup(proc, "SIGTERM");
await new Promise((resolve) => {
const timeout = setTimeout(() => {
if (proc) killProcessGroup(proc, "SIGKILL");
resolve();
}, GRACEFUL_STOP_TIMEOUT_MS);
if (proc) {
proc.once("close", () => {
clearTimeout(timeout);
resolve();
});
} else {
clearTimeout(timeout);
resolve();
}
});
}
// Logical CPUs this process may use: unlike os.cpus().length this honours
// affinity masks and container limits, so inference thread counts fit the
// cores the sidecar will actually get.
function getAvailableParallelism() {
return os.availableParallelism();
}
module.exports = {
findAvailablePort,
isPortAvailable,
resolveBinaryPath,
gracefulStopProcess,
getAvailableParallelism,
};