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 { spawn } = require("child_process");
const { app } = require("electron");
const path = require("path");
const fs = require("fs");
const { promises: fsPromises } = require("fs");
/**
* LlamaCppInstaller - Manages llama-server binary availability
*
* Note: This module is kept for backwards compatibility and system installation checks.
* The bundled llama-server binary is primarily managed by LlamaServerManager.
*/
class LlamaCppInstaller {
constructor() {
// IMPORTANT: Do NOT call app.getPath() here!
// It can hang or fail before app.whenReady() in Electron 36+.
this.installDir = null;
this.binPath = null;
this.platform = process.platform;
this.arch = process.arch;
this._initialized = false;
}
/**
* Ensures the installer is initialized. Safe to call multiple times.
*/
ensureInitialized() {
if (this._initialized) return;
if (!app.isReady()) {
throw new Error(
"LlamaCppInstaller cannot be initialized before app.whenReady(). " +
"This is a programming error."
);
}
this.installDir = path.join(app.getPath("userData"), "llama-cpp");
this._initialized = true;
}
async ensureInstallDir() {
this.ensureInitialized();
await fsPromises.mkdir(this.installDir, { recursive: true });
}
getBinaryName() {
// llama-server binary name
return this.platform === "win32" ? "llama-server.exe" : "llama-server";
}
getInstalledBinaryPath() {
this.ensureInitialized();
return path.join(this.installDir, this.getBinaryName());
}
async isInstalled() {
try {
// First check for system installation
const systemPath = await this.getSystemBinaryPath();
if (systemPath) {
this.binPath = systemPath;
return true;
}
// Then check for local installation
const binaryPath = this.getInstalledBinaryPath();
await fsPromises.access(binaryPath, fs.constants.X_OK);
this.binPath = binaryPath;
return true;
} catch {
return false;
}
}
async getSystemBinaryPath() {
return new Promise((resolve) => {
const checkCmd = this.platform === "win32" ? "where.exe" : "which";
const binaryNames = this.platform === "win32" ? ["llama-server.exe"] : ["llama-server"];
let found = false;
let remaining = binaryNames.length;
for (const name of binaryNames) {
const proc = spawn(checkCmd, [name], {
windowsHide: true,
stdio: "pipe",
});
let output = "";
proc.stdout.on("data", (data) => {
output += data.toString();
});
proc.on("close", (code) => {
if (!found && code === 0 && output) {
found = true;
resolve(output.trim().split(/\r?\n/)[0]);
}
remaining--;
if (remaining === 0 && !found) {
resolve(null);
}
});
proc.on("error", () => {
remaining--;
if (remaining === 0 && !found) {
resolve(null);
}
});
}
});
}
async checkSystemInstallation() {
const systemPath = await this.getSystemBinaryPath();
return systemPath !== null;
}
async install() {
try {
await this.ensureInstallDir();
// Return a message about manual installation
// The bundled binary is managed by LlamaServerManager
return {
success: false,
message:
"Please install llama.cpp manually using Homebrew (macOS): brew install llama.cpp, " +
"or ensure the llama-server binary is bundled with the app.",
};
} catch (error) {
return {
success: false,
message: `Installation failed: ${error.message}`,
};
}
}
async uninstall() {
try {
const binaryPath = this.getInstalledBinaryPath();
await fsPromises.unlink(binaryPath);
this.binPath = null;
return { success: true };
} catch (error) {
return {
success: false,
message: `Uninstall failed: ${error.message}`,
};
}
}
async getBinaryPath() {
if (this.binPath) {
return this.binPath;
}
// Check for system installation
const systemPath = await this.getSystemBinaryPath();
if (systemPath) {
this.binPath = systemPath;
return systemPath;
}
// Fall back to local installation
return this.getInstalledBinaryPath();
}
}
module.exports = { default: new LlamaCppInstaller() };