beast-agent 2.44.10 → 2.44.11

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "beast-agent",
     "productName": "Beast Agent",
-    "version": "2.44.10",
+    "version": "2.44.11",
     "description": "Ultra-fast local agent shell for Windows.",
     "author": "algokodcom (AlgoKod)",
     "license": "MIT",

package/src/agent/piper.js

@@ -0,0 +1,246 @@
+'use strict';
+
+/* Beast Piper TTS: tamamen YEREL/offline neural seslendirme (rhasspy/piper).
+   - Runtime: piper_windows_amd64.zip (~21MB) → %APPDATA%\beast\piper\bin
+     (piper.exe + espeak-ng-data + onnxruntime dll'leri birlikte gelir)
+   - Sesler: diffusionstudio/piper-voices aynası → %APPDATA%\beast\piper\voices
+     (tr_TR fahrettin/fettah medium = CC0; en_US lessac/amy medium)
+   - piper.exe stdin metin → stdout WAV (22.05kHz mono 16-bit). mp3/ogg
+     dönüşümü gerekmez: WhatsApp sesli not yolu ffmpeg ile ogg/opus'a çevirir,
+     masaüstü oynatıcı WAV'ı doğrudan çalar.
+   - İndirmeler kilitli: aynı anda iki kez başlamaz; ilerleme progressbus
+     üzerinden Kurulum/Ayarlar panesine akar. Hata olursa bir sonraki
+     çağrıda yeniden denenir. */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn, execFile } = require('child_process');
+const { Readable } = require('stream');
+const { pipeline } = require('stream/promises');
+const { beastRoot } = require('./memory');
+const log = require('./logger');
+const { emitInstallProgress } = require('./progressbus');
+
+const PIPER_VERSION = '2023.11.14-2';
+const RUNTIME_URL = `https://github.com/rhasspy/piper/releases/download/${PIPER_VERSION}/piper_windows_amd64.zip`;
+const VOICE_BASE = 'https://huggingface.co/diffusionstudio/piper-voices/resolve/main';
+const DEFAULT_VOICE = 'tr_TR-fahrettin-medium';
+
+/* UI'da listelenen sesler — indirme url'si VOICE_BASE + path + .onnx(.json) */
+const VOICES = {
+  'tr_TR-fahrettin-medium': { name: 'Fahrettin — Türkçe (erkek)', path: 'tr/tr_TR/fahrettin/medium/tr_TR-fahrettin-medium' },
+  'tr_TR-fettah-medium': { name: 'Fettah — Türkçe (erkek)', path: 'tr/tr_TR/fettah/medium/tr_TR-fettah-medium' },
+  'en_US-lessac-medium': { name: 'Lessac — English (male)', path: 'en/en_US/lessac/medium/en_US-lessac-medium' },
+  'en_US-amy-medium': { name: 'Amy — English (female)', path: 'en/en_US/amy/medium/en_US-amy-medium' },
+};
+
+function rootDir() {
+  return path.join(beastRoot(), 'piper');
+}
+function binDir() {
+  return path.join(rootDir(), 'bin');
+}
+function voicesDir() {
+  return path.join(rootDir(), 'voices');
+}
+function exePath() {
+  return path.join(binDir(), 'piper.exe');
+}
+function voicePath(id) {
+  return path.join(voicesDir(), String(id) + '.onnx');
+}
+function voiceJsonPath(id) {
+  return voicePath(id) + '.json';
+}
+
+function resolveVoice(id) {
+  const v = String(id || '').trim();
+  return VOICES[v] ? v : DEFAULT_VOICE;
+}
+
+function runtimeInstalled() {
+  try {
+    return fs.existsSync(exePath());
+  } catch {
+    return false;
+  }
+}
+function voiceInstalled(id) {
+  try {
+    return !!VOICES[id] && fs.existsSync(voicePath(id)) && fs.existsSync(voiceJsonPath(id));
+  } catch {
+    return false;
+  }
+}
+
+/* ---------- indirme (yüzde akışlı, .part → atomik rename) ---------- */
+
+async function download(url, dest, tag) {
+  const res = await fetch(url, { redirect: 'follow' });
+  if (!res.ok || !res.body) throw new Error('indirilemedi (http ' + res.status + ')');
+  const total = Number(res.headers.get('content-length')) || 0;
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  const tmp = dest + '.part';
+  let loaded = 0;
+  let last = 0;
+  const rs = Readable.fromWeb(res.body);
+  rs.on('data', (c) => {
+    loaded += c.length;
+    const now = Date.now();
+    if (now - last > 500) {
+      last = now;
+      emitInstallProgress(tag, { pct: total ? Math.round((loaded / total) * 100) : 0, loaded, total });
+    }
+  });
+  await pipeline(rs, fs.createWriteStream(tmp));
+  fs.renameSync(tmp, dest);
+  emitInstallProgress(tag, { pct: 100, loaded, total: total || loaded });
+}
+
+function unzip(zip, dest) {
+  return new Promise((resolve, reject) => {
+    const q = (s) => "'" + String(s).replace(/'/g, "''") + "'";
+    execFile(
+      'powershell.exe',
+      ['-NoProfile', '-NonInteractive', '-Command',
+        `Expand-Archive -LiteralPath ${q(zip)} -DestinationPath ${q(dest)} -Force`],
+      { timeout: 5 * 60 * 1000, windowsHide: true },
+      (err) => (err ? reject(err) : resolve())
+    );
+  });
+}
+
+/* ---------- kurulum (kilitli) ---------- */
+
+let runtimePromise = null;
+const voicePromises = new Map();
+
+function ensureRuntime() {
+  if (runtimeInstalled()) return Promise.resolve(true);
+  if (runtimePromise) return runtimePromise;
+  runtimePromise = (async () => {
+    const zip = path.join(rootDir(), 'piper-' + PIPER_VERSION + '.zip');
+    log.info('piper', 'runtime indiriliyor: ' + RUNTIME_URL);
+    await download(RUNTIME_URL, zip, 'piper-runtime');
+    const tmp = path.join(rootDir(), '.extract');
+    fs.rmSync(tmp, { recursive: true, force: true });
+    fs.mkdirSync(tmp, { recursive: true });
+    await unzip(zip, tmp);
+    const inner = path.join(tmp, 'piper');
+    const src = fs.existsSync(path.join(inner, 'piper.exe')) ? inner : tmp;
+    fs.mkdirSync(binDir(), { recursive: true });
+    for (const e of fs.readdirSync(src)) {
+      const from = path.join(src, e);
+      const to = path.join(binDir(), e);
+      fs.rmSync(to, { recursive: true, force: true });
+      fs.renameSync(from, to);
+    }
+    fs.rmSync(tmp, { recursive: true, force: true });
+    try { fs.unlinkSync(zip); } catch {}
+    if (!runtimeInstalled()) throw new Error('piper.exe çıkarılamadı');
+    log.info('piper', 'runtime hazır: ' + exePath());
+    return true;
+  })().catch((e) => {
+    log.error('piper', 'runtime kurulumu başarısız: ' + String((e && e.message) || e));
+    throw e;
+  }).finally(() => {
+    runtimePromise = null; // kilit çözülür; kuruluysa yukarıdaki kısa yol devrede
+  });
+  return runtimePromise;
+}
+
+function ensureVoice(id) {
+  const vid = resolveVoice(id);
+  if (voiceInstalled(vid)) return Promise.resolve(true);
+  if (voicePromises.has(vid)) return voicePromises.get(vid);
+  const p = (async () => {
+    const base = VOICE_BASE + '/' + VOICES[vid].path;
+    log.info('piper', 'ses modeli indiriliyor: ' + vid);
+    await download(base + '.onnx', voicePath(vid), 'piper-voice');
+    await download(base + '.onnx.json', voiceJsonPath(vid), 'piper-voice');
+    if (!voiceInstalled(vid)) throw new Error('ses modeli indirilemedi: ' + vid);
+    log.info('piper', 'ses hazır: ' + vid);
+    return true;
+  })().catch((e) => {
+    log.error('piper', 'ses indirme başarısız (' + vid + '): ' + String((e && e.message) || e));
+    throw e;
+  }).finally(() => {
+    voicePromises.delete(vid); // kilit çözülür; kuruluysa yukarıdaki kısa yol devrede
+  });
+  voicePromises.set(vid, p);
+  return p;
+}
+
+/* UI/Kurulum için durum: { installed, runtime, voice, voiceId, installing } */
+function status(voiceId) {
+  const vid = resolveVoice(voiceId);
+  return {
+    installed: runtimeInstalled() && voiceInstalled(vid),
+    runtime: runtimeInstalled(),
+    voice: voiceInstalled(vid),
+    voiceId: vid,
+    installing: !!runtimePromise || voicePromises.has(vid),
+  };
+}
+
+/* elle/otomatik kurulum: runtime + ses (hata fırlatmaz, {ok} döner) */
+async function install(voiceId) {
+  const vid = resolveVoice(voiceId);
+  try {
+    await ensureRuntime();
+    await ensureVoice(vid);
+    return { ok: true, voice: vid };
+  } catch (e) {
+    return { ok: false, voice: vid, error: String((e && e.message) || e) };
+  }
+}
+
+/* ---------- sentez: metin → { audio: WAV buffer, mime } ---------- */
+
+function synthesize(text, opts = {}) {
+  const vid = resolveVoice(opts.voice);
+  return (async () => {
+    await ensureRuntime();
+    await ensureVoice(vid);
+    return new Promise((resolve, reject) => {
+      const args = [
+        '--model', voicePath(vid),
+        '--config', voiceJsonPath(vid),
+        '--output_file', '-',
+        '-q',
+      ];
+      const p = spawn(exePath(), args, { windowsHide: true, cwd: binDir() });
+      const chunks = [];
+      let err = '';
+      const timer = setTimeout(() => {
+        try { p.kill(); } catch {}
+        reject(new Error('piper zaman aşımı'));
+      }, 120000);
+      p.stdout.on('data', (d) => chunks.push(d));
+      p.stderr.on('data', (d) => { err += d.toString(); });
+      p.on('error', (e) => { clearTimeout(timer); reject(e); });
+      p.on('close', (code) => {
+        clearTimeout(timer);
+        const buf = Buffer.concat(chunks);
+        if (code !== 0 || buf.length < 44) {
+          return reject(new Error('piper başarısız (kod ' + code + '): ' + err.slice(0, 140)));
+        }
+        resolve({ audio: buf, mime: 'audio/wav' });
+      });
+      p.stdin.write(String(text).slice(0, 4000));
+      p.stdin.end();
+    });
+  })();
+}
+
+module.exports = {
+  VOICES,
+  DEFAULT_VOICE,
+  synthesize,
+  install,
+  status,
+  ensureRuntime,
+  ensureVoice,
+  runtimeInstalled,
+  voiceInstalled,
+};

package/src/main.js

@@ -26,6 +26,7 @@ const watchers = require('./agent/watchers');
 const usageMod = require('./agent/usage');
 const bus = require('./agent/bus');
 const computeruse = require('./agent/computeruse');
+const piper = require('./agent/piper');
 const fsguard = require('./agent/fsguard');
 const log = require('./agent/logger');
 const squeeze = require('./agent/squeeze');
@@ -1035,17 +1036,28 @@ async function transcribePcm(audio, langOverride) {
   }
 }
 
+/* TTS sentezi: dönen değer { audio: Buffer, mime } — motor seçilebilir.
+   - edge: ücretsiz Microsoft neural (MP3)
+   - piper: tamamen yerel/offline neural (WAV; ilk kullanımda indirilir)
+   - openai: OpenAI-uyumlu /audio/speech API (MP3) */
 async function synthesizeSpeech(text) {
   const cfg = settings.waTts || {};
   if (!cfg.enabled) return null;
   try {
+    const engine = cfg.engine || 'edge';
     /* EDGE TTS: ücretsiz yerel motor — baseUrl/key GEREKMEZ */
-    if ((cfg.engine || 'edge') === 'edge') {
+    if (engine === 'edge') {
       const edge = require('./agent/edgetts');
       const audio = await edge.synthesize(String(text).slice(0, 4000), {
         voice: cfg.edgeVoice || 'tr-TR-AhmetNeural',
       });
-      return audio;
+      return audio && { audio, mime: 'audio/mpeg' };
+    }
+    /* PIPER: yerel/offline — ilk kullanımda runtime + ses modeli indirilir */
+    if (engine === 'piper') {
+      return await piper.synthesize(String(text).slice(0, 4000), {
+        voice: cfg.piperVoice || piper.DEFAULT_VOICE,
+      });
     }
     if (!cfg.baseUrl || !cfg.key) return null;
     const url = String(cfg.baseUrl).replace(/\/+$/, '') + '/audio/speech';
@@ -1068,7 +1080,7 @@ async function synthesizeSpeech(text) {
       waLog(`tts http ${res.status}`);
       return null;
     }
-    return Buffer.from(await res.arrayBuffer());
+    return { audio: Buffer.from(await res.arrayBuffer()), mime: 'audio/mpeg' };
   } catch (e) {
     waLog('tts hata: ' + String((e && e.message) || e));
     return null;
@@ -3385,7 +3397,7 @@ function reloadBackend() {
                     return;
                   }
                   const voice = await synthesizeSpeech(txt);
-                  if (voice) await wa.sendAudio(wajid, voice).catch(() => {});
+                  if (voice && voice.audio) await wa.sendAudio(wajid, voice.audio).catch(() => {});
                 }
               }
             } catch {}
@@ -12857,11 +12869,14 @@ ipcMain.handle('wa:sessions', () => [...waChats.values()]);
 
 ipcMain.handle('wa:tts:get', () => settings.waTts || {});
 ipcMain.handle('wa:tts:set', (_e, cfg) => {
+  const eng = String((cfg && cfg.engine) || 'edge');
+  const pv = String((cfg && cfg.piperVoice) || '').trim();
   settings.waTts = {
     enabled: !!(cfg && cfg.enabled),
-    /* motor: 'edge' (ücretsiz yerel, varsayılan) | 'openai' (OpenAI-uyumlu API) */
-    engine: (cfg && cfg.engine) === 'openai' ? 'openai' : 'edge',
+    /* motor: 'edge' (ücretsiz bulut, varsayılan) | 'piper' (yerel/offline) | 'openai' (API) */
+    engine: ['edge', 'piper', 'openai'].includes(eng) ? eng : 'edge',
     edgeVoice: String((cfg && cfg.edgeVoice) || 'tr-TR-AhmetNeural').trim(),
+    piperVoice: piper.VOICES[pv] ? pv : piper.DEFAULT_VOICE,
     chatAutoSpeak: !!(cfg && cfg.chatAutoSpeak),
     baseUrl: String((cfg && cfg.baseUrl) || '').trim(),
     key: String((cfg && cfg.key) || '').trim(),
@@ -12872,6 +12887,15 @@ ipcMain.handle('wa:tts:set', (_e, cfg) => {
   return settings.waTts;
 });
 
+/* PIPER (yerel/offline TTS): durum + elle indirme (runtime + ses modeli) */
+ipcMain.handle('piper:status', (_e, voice) => {
+  try { return piper.status(String(voice || '')); } catch { return { installed: false, runtime: false, voice: false, installing: false }; }
+});
+ipcMain.handle('piper:install', async (_e, voice) => {
+  const r = await piper.install(String(voice || ''));
+  return { ...r, status: piper.status(String(voice || '')) };
+});
+
 /* CHAT TTS: masaüstü sohbetinde ajanın son yazısını seslendirir (base64 mp3).
    chatAutoSpeak açıkken renderer 'done' olayında bu kanalı çağırır. */
 ipcMain.handle('tts:synthesize', async (_e, text) => {
@@ -12879,13 +12903,14 @@ ipcMain.handle('tts:synthesize', async (_e, text) => {
   if (!cfg.enabled) return { ok: false, error: 'tts kapalı' };
   const t = String(text || '').trim();
   if (!t) return { ok: false, error: 'boş metin' };
-  const audio = await synthesizeSpeech(t.slice(0, 4000));
-  if (!audio) {
+  const out = await synthesizeSpeech(t.slice(0, 4000));
+  if (!out || !out.audio) {
     waLog('tts chat seslendirilemedi — motor: ' + (cfg.engine || 'edge'));
     return { ok: false, error: 'seslendirilemedi' };
   }
-  waLog('tts chat ok: ' + audio.length + ' bayt, motor: ' + (cfg.engine || 'edge') + ', ses: ' + (cfg.edgeVoice || '-'));
-  return { ok: true, audioB64: audio.toString('base64'), mime: 'audio/mpeg' };
+  const ses = cfg.engine === 'piper' ? (cfg.piperVoice || piper.DEFAULT_VOICE) : (cfg.edgeVoice || '-');
+  waLog('tts chat ok: ' + out.audio.length + ' bayt, motor: ' + (cfg.engine || 'edge') + ', ses: ' + ses);
+  return { ok: true, audioB64: out.audio.toString('base64'), mime: out.mime || 'audio/mpeg' };
 });
 
 /* ---------- Telegram IPC (FEATURE 3) ---------- */

package/src/preload.js

@@ -203,6 +203,8 @@ contextBridge.exposeInMainWorld('beast', {
   setWaLockdown: (v) => ipcRenderer.invoke('wa:lockdown:set', v),
   waGetTts: () => ipcRenderer.invoke('wa:tts:get'),
   waSetTts: (cfg) => ipcRenderer.invoke('wa:tts:set', cfg),
+  piperStatus: (voice) => ipcRenderer.invoke('piper:status', voice),
+  piperInstall: (voice) => ipcRenderer.invoke('piper:install', voice),
   waGetGroups: () => ipcRenderer.invoke('wa:groups:get'),
   waSetGroups: (cfg) => ipcRenderer.invoke('wa:groups:set', cfg),
   tgGetStatus: () => ipcRenderer.invoke('tg:status:get'),

package/src/renderer/i18n.js

@@ -268,9 +268,11 @@
       tts_save: 'TTS Kaydet',
       tts_test: 'Test sesi çal',
       stt_download_now: 'Şimdi indir / hazırla',
-      tts_note: 'Edge TTS: ücretsiz yerel motor — anahtar gerekmez (Ahmet/Emel vb.). OpenAI motoru: uyumlu speech API (tts-1, tts-1-hd; sesler alloy, echo, fable, onyx, nova, shimmer).',
+      tts_note: 'Edge TTS: ücretsiz bulut motoru — anahtar gerekmez (Ahmet/Emel vb.). Piper: tamamen yerel/offline neural motor (ilk kullanımda ~80MB indirir). OpenAI motoru: uyumlu speech API (tts-1, tts-1-hd; sesler alloy, echo, fable, onyx, nova, shimmer).',
       tts_engine: 'Motor',
       tts_edge_voice: 'Edge sesi',
+      tts_piper_voice: 'Piper sesi',
+      tts_piper_download: 'Piper\'ı indir / hazırla',
       tts_chat_auto: 'Chat\'te ajanın yazdıklarını otomatik seslendir',
       tts_on: 'TTS açık — cevaplar sesli de gider',
       tts_off: 'TTS kapalı',
@@ -992,9 +994,11 @@
       tts_save: 'Save TTS',
       tts_test: 'Play test sound',
       stt_download_now: 'Download / prepare now',
-      tts_note: 'Edge TTS: free local engine — no key needed (Ahmet/Emel etc.). OpenAI engine: compatible speech API (tts-1, tts-1-hd; voices alloy, echo, fable, onyx, nova, shimmer).',
+      tts_note: 'Edge TTS: free cloud engine — no key needed (Ahmet/Emel etc.). Piper: fully local/offline neural engine (downloads ~80MB on first use). OpenAI engine: compatible speech API (tts-1, tts-1-hd; voices alloy, echo, fable, onyx, nova, shimmer).',
       tts_engine: 'Engine',
       tts_edge_voice: 'Edge voice',
+      tts_piper_voice: 'Piper voice',
+      tts_piper_download: 'Download / prepare Piper',
       tts_chat_auto: 'Auto-speak agent replies in chat',
       tts_on: 'TTS on — replies also go as voice',
       tts_off: 'TTS off',

package/src/renderer/renderer.js

@@ -2580,6 +2580,14 @@ async function renderTtsPane() {  const pane = $('#tab-tts');
   ]
     .map(([v, n]) => `<option value="${v}">${n}</option>`)
     .join('');
+  const piperOpts = [
+    ['tr_TR-fahrettin-medium', 'Fahrettin — Türkçe (erkek)'],
+    ['tr_TR-fettah-medium', 'Fettah — Türkçe (erkek)'],
+    ['en_US-lessac-medium', 'Lessac — English (male)'],
+    ['en_US-amy-medium', 'Amy — English (female)'],
+  ]
+    .map(([v, n]) => `<option value="${v}">${n}</option>`)
+    .join('');
   pane.innerHTML =
     '<h2>' + _t('tts_h2') + '</h2><div class="sub">' + _t('tts_sub') + '</div>' +
     '<div class="sub" style="margin:10px 0 4px;font-weight:700;color:var(--accent)">STT (Ses → Yazı)</div>' +
@@ -2590,11 +2598,18 @@ async function renderTtsPane() {  const pane = $('#tab-tts');
       <label class="lock-row"><input type="checkbox" id="ttsOn" /><span>${_t('tts_active')}</span></label>
       <label style="grid-column:1">${_t('tts_engine')}</label>
       <select id="ttsEngine" class="inp" style="grid-column:2/4">
-        <option value="edge">Edge TTS — yerel & ücretsiz (Ahmet/Emel…)</option>
+        <option value="edge">Edge TTS — ücretsiz bulut (Ahmet/Emel…)</option>
+        <option value="piper">Piper — yerel & offline (Fahrettin/Fettah…)</option>
         <option value="openai">OpenAI-uyumlu API (tts-1, ses: alloy…)</option>
       </select>
       <label style="grid-column:1">${_t('tts_edge_voice')}</label>
       <select id="ttsEdgeVoice" class="inp" style="grid-column:2/4">${edgeOpts}</select>
+      <label style="grid-column:1">${_t('tts_piper_voice')}</label>
+      <select id="ttsPiperVoice" class="inp" style="grid-column:2/4">${piperOpts}</select>
+      <span id="piperStatusRow" style="grid-column:1/4;display:flex;gap:10px;align-items:center">
+        <span class="sub" id="piperStatusTxt" style="margin:0"></span>
+        <button id="piperDlBtn" class="btn ghost">${_t('tts_piper_download')}</button>
+      </span>
       <label class="lock-row" style="grid-column:1/4"><input type="checkbox" id="ttsChatAuto" /><span>${_t('tts_chat_auto')}</span></label>
       <span id="ttsOpenaiWrap" style="display:contents">
         <input id="ttsUrl" class="inp" placeholder="https://api.openai.com/v1" autocomplete="off" />
@@ -2608,25 +2623,62 @@ async function renderTtsPane() {  const pane = $('#tab-tts');
     '<div class="sub" style="margin-top:8px">' + _t('tts_note') + '</div>';
 
   const syncEngineUi = () => {
-    const isEdge = $('#ttsEngine').value === 'edge';
+    const eng = $('#ttsEngine').value;
+    const isEdge = eng === 'edge';
+    const isPiper = eng === 'piper';
     $('#ttsEdgeVoice').disabled = !isEdge;
-    $('#ttsOpenaiWrap').style.opacity = isEdge ? '0.35' : '1';
-    $('#ttsOpenaiWrap').querySelectorAll('input').forEach((i) => (i.disabled = isEdge));
+    $('#ttsPiperVoice').disabled = !isPiper;
+    $('#piperDlBtn').disabled = !isPiper;
+    $('#piperStatusTxt').style.opacity = isPiper ? '1' : '0.45';
+    $('#ttsOpenaiWrap').style.opacity = eng === 'openai' ? '1' : '0.35';
+    $('#ttsOpenaiWrap').querySelectorAll('input').forEach((i) => (i.disabled = eng !== 'openai'));
   };
 
   try {
     const tts = await beast.waGetTts();
     $('#ttsOn').checked = !!tts.enabled;
-    $('#ttsEngine').value = tts.engine === 'openai' ? 'openai' : 'edge';
+    $('#ttsEngine').value = ['edge', 'piper', 'openai'].includes(tts.engine) ? tts.engine : 'edge';
     $('#ttsEdgeVoice').value = tts.edgeVoice || 'tr-TR-AhmetNeural';
+    $('#ttsPiperVoice').value = tts.piperVoice || 'tr_TR-fahrettin-medium';
     $('#ttsChatAuto').checked = !!tts.chatAutoSpeak;
     $('#ttsUrl').value = tts.baseUrl || '';
     $('#ttsKey').value = tts.key || '';
     $('#ttsModel').value = tts.model || 'tts-1';
     $('#ttsVoice').value = tts.voice || 'alloy';
   } catch {}
+
+  /* Piper durum satırı: runtime/ses modeli hazır mı (indirilince güncellenir) */
+  const refreshPiperStatus = async () => {
+    const v = $('#ttsPiperVoice') ? $('#ttsPiperVoice').value : '';
+    try {
+      const st = await beast.piperStatus(v);
+      const el = $('#piperStatusTxt');
+      if (el && st) {
+        el.textContent = 'Piper: ' + (st.installed
+          ? 'hazır — yerel/offline'
+          : st.installing
+            ? 'indiriliyor…'
+            : st.runtime
+              ? 'ses modeli indirilecek (ilk kullanımda otomatik)'
+              : 'runtime + ses modeli indirilecek (ilk kullanımda otomatik)');
+      }
+      return st;
+    } catch { return null; }
+  };
+
   syncEngineUi();
-  $('#ttsEngine').addEventListener('change', syncEngineUi);
+  await refreshPiperStatus();
+  $('#ttsEngine').addEventListener('change', () => { syncEngineUi(); refreshPiperStatus(); });
+  $('#ttsPiperVoice').addEventListener('change', refreshPiperStatus);
+  $('#piperDlBtn').addEventListener('click', async () => {
+    const v = $('#ttsPiperVoice').value;
+    toast('Piper indiriliyor… (ilk seferde ~80MB)');
+    const poll = setInterval(refreshPiperStatus, 4000);
+    const r = await beast.piperInstall(v).catch((e) => ({ ok: false, error: String((e && e.message) || e) }));
+    clearInterval(poll);
+    await refreshPiperStatus();
+    toast(r && r.ok ? 'Piper hazır ✓ — artık çevrimdışı seslendirme yapılır' : 'Piper indirilemedi: ' + ((r && r.error) || '?'));
+  });
 
   /* STT durum satırı: yenile + şimdi indir (yüklenirken 3 sn'de bir güncellenir) */
   const refreshSttStatus = async () => {
@@ -2650,6 +2702,7 @@ async function renderTtsPane() {  const pane = $('#tab-tts');
       enabled: $('#ttsOn').checked,
       engine: $('#ttsEngine').value,
       edgeVoice: $('#ttsEdgeVoice').value,
+      piperVoice: $('#ttsPiperVoice').value,
       chatAutoSpeak: $('#ttsChatAuto').checked,
       baseUrl: $('#ttsUrl').value.trim(),
       key: $('#ttsKey').value.trim(),
@@ -2664,8 +2717,14 @@ async function renderTtsPane() {  const pane = $('#tab-tts');
   });
   $('#ttsTest').addEventListener('click', async () => {
     /* motor + IPC + çalma zincirini uçtan uca dener — sorun neredeyse görünür */
-    toast('TTS test ediliyor…');
-    const r = await beast.ttsSpeak('Merhaba kanka, Edge TTS testi. Ben Beast.').catch((e) => ({ ok: false, error: String((e && e.message) || e) }));
+    const eng = $('#ttsEngine').value;
+    const line = eng === 'piper'
+      ? 'Merhaba kanka, Piper yerel TTS testi. Ben Beast.'
+      : eng === 'openai'
+        ? 'Merhaba kanka, OpenAI TTS testi. Ben Beast.'
+        : 'Merhaba kanka, Edge TTS testi. Ben Beast.';
+    toast(eng === 'piper' ? 'TTS test ediliyor… (Piper ilk seferde indiriyorsa uzun sürebilir)' : 'TTS test ediliyor…');
+    const r = await beast.ttsSpeak(line).catch((e) => ({ ok: false, error: String((e && e.message) || e) }));
     if (!(r && r.ok)) { toast('TTS test HATA: ' + ((r && r.error) || '?')); return; }
     try {
       await playTtsB64(r);