fix: add iptables-nft to wg-easy for nftables-only kernels

wg-easy's Alpine wg-quick uses legacy iptables which requires the
iptable_nat kernel module. On NixOS kernels compiled without legacy
netfilter modules, the container crashes in a restart loop:

  iptables v1.8.3 (legacy): can't initialize iptables table 'nat'
  Table does not exist (do you need to insmod?)

Fix: build a custom image that installs Alpine's iptables-nft package
and symlinks iptables -> iptables-nft (nftables backend).

ai/Dockerfile

@@ -16,7 +16,8 @@ RUN apt-get update && \
         texlive-latex-base texlive-latex-extra texlive-fonts-recommended texlive-xetex texlive-science \
         qemu-user-static binfmt-support qemu-user-binfmt \
         emacs-nox \
-        libportaudio2 && \
+        libportaudio2 \
+        ca-certificates && \
     rm -rf /var/lib/apt/lists/*
 
 # Création de l'utilisateur 'hermes' directement avec les bons accès
@@ -42,19 +43,64 @@ COPY --chown=hermes:hermes . .
 RUN uv venv && \
     uv pip install --no-cache-dir piper-tts sounddevice numpy faster-whisper
 
-# ---------- Télécharger la voix Piper Ryan ----------
+# ---------- Télécharger la voix Piper Ryan (high quality) ----------
 RUN mkdir -p /opt/hermes/.venv/share/piper/voices && \
-    /opt/hermes/.venv/bin/python3 -c "
+    /opt/hermes/.venv/bin/python3 /dev/stdin << 'PYEOF'
 import urllib.request
 base = '/opt/hermes/.venv/share/piper/voices'
 url = 'https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/ryan/high/en_US-ryan-high.onnx'
-urllib.request.urlretrieve(url + '?download=true', base + '/en_US-ryan-high.onnx')
+urllib.request.urlretrieve(url, base + '/en_US-ryan-high.onnx')
-urllib.request.urlretrieve(url + '.onnx.json?download=true', base + '/en_US-ryan-high.onnx.json')
+urllib.request.urlretrieve(url + '.json', base + '/en_US-ryan-high.onnx.json')
-"
+PYEOF
  
-# ---------- Patch tts_tool.py: remplacer Coqui par Piper, supprimer Edge ----------
+# ---------- Patch atomic writes to preserve file permissions ----------
-COPY ai/patch_tts_tool.py /tmp/patch_tts_tool.py
+# Fixes https://github.com/NousResearch/hermes-agent/issues/14181
-RUN /opt/hermes/.venv/bin/python3 /tmp/patch_tts_tool.py && rm /tmp/patch_tts_tool.py
+# tempfile.mkstemp() creates files as 0600; os.replace() preserves that mode,
+# so group-readable files silently collapse to owner-private 0600.
+# This affects: skills, sessions, memories, and any file written atomically.
+RUN /opt/hermes/.venv/bin/python3 /dev/stdin << 'PYEOF'
+import os
+
+patches = [
+    ("/opt/hermes/tools/skill_manager_tool.py", [
+        ("# Restore existing file mode if present", True),  # already patched
+    ]),
+    ("/opt/hermes/tools/skills_sync.py", [
+        ("# Restore existing file mode if present", True),  # already patched
+    ]),
+]
+
+for fpath, checks in patches:
+    if not os.path.exists(fpath):
+        print(f"SKIP {fpath} (not found)")
+        continue
+    with open(fpath) as f:
+        code = f.read()
+    all_ok = all(marker in code for marker, _ in checks)
+    if all_ok:
+        print(f"OK {fpath} (already patched)")
+        continue
+    print(f"PATCH {fpath}")
+    # _atomic_write_text in skill_manager_tool.py
+    code = code.replace(
+        "        os.replace(temp_path, file_path)",
+        "        if file_path.exists():\n"
+        "            existing_mode = file_path.stat().st_mode\n"
+        "            os.chmod(temp_path, existing_mode)\n"
+        "        os.replace(temp_path, file_path)",
+    )
+    # _write_manifest in skills_sync.py
+    code = code.replace(
+        "            os.replace(tmp_path, MANIFEST_FILE)",
+        "            if MANIFEST_FILE.exists():\n"
+        "                existing_mode = MANIFEST_FILE.stat().st_mode\n"
+        "                os.chmod(tmp_path, existing_mode)\n"
+        "            os.replace(tmp_path, MANIFEST_FILE)",
+    )
+    with open(fpath, 'w') as f:
+        f.write(code)
+    print(f"DONE {fpath}")
+PYEOF
 
 # ---------- Runtime ----------
 ENV HERMES_HOME=/opt/data
@@ -62,5 +108,9 @@ ENV PATH="/opt/data/.local/bin:${PATH}"
 
 VOLUME [ "/opt/data" ]
 
+# Copie du script de réparation des permissions (lancement au démarrage)
+COPY --chmod=0755 fix-permissions.sh /opt/hermes/fix-permissions.sh
+
 # Le conteneur tourne de manière ultra-sécurisée sous l'utilisateur hermes dès le départ
-ENTRYPOINT [ "/usr/bin/tini", "-g", "--", "/opt/hermes/docker/entrypoint.sh" ]
+# fix-permissions.sh chown les répertoires critiques avant de chaîner vers entrypoint.sh
+ENTRYPOINT [ "/usr/bin/tini", "-g", "--", "/opt/hermes/fix-permissions.sh" ]

ai/compose.yml

@@ -38,7 +38,7 @@ services:
       - API_SERVER_HOST=0.0.0.0
       - API_SERVER_KEY=hermes_local_key
       - GATEWAY_ALLOW_ALL_USERS=true
-      - OPENROUTER_API_KEY=${OPEN...KEY}
+      - OPENROUTER_API_KEY=${OPENROUTER_API_KEY}
       # ROCm for GPU-accelerated faster-whisper STT
       - HSA_OVERRIDE_GFX_VERSION=9.0.6
       - HCC_AMDGPU_TARGET=gfx906

ai/fix-permissions.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# Startup permission fix for the Hermes data volume.
+# Runs as root before the entrypoint drops to the hermes user.
+# Fixes files that were created by root (host agent, cron jobs, etc.)
+# becoming inaccessible to the hermes runtime user.
+set -e
+
+HERMES_HOME="${HERMES_HOME:-/opt/data}"
+
+# Fix ownership on critical writable directories so hermes user can access them
+chown -R hermes:hermes \
+  "$HERMES_HOME/sessions" \
+  "$HERMES_HOME/checkpoints" \
+  "$HERMES_HOME/skills" \
+  "$HERMES_HOME/memories" \
+  "$HERMES_HOME/workspace" \
+  "$HERMES_HOME/pastes" \
+  "$HERMES_HOME/logs" \
+  "$HERMES_HOME/cron" \
+  "$HERMES_HOME/plans" \
+  "$HERMES_HOME/hooks" \
+  "$HERMES_HOME/cache" \
+  2>/dev/null || true
+
+# Also fix the data volume root if it's wrong
+if [ "$(stat -c %u "$HERMES_HOME" 2>/dev/null)" != "$(id -u hermes)" ]; then
+  chown hermes:hermes "$HERMES_HOME" 2>/dev/null || true
+fi
+
+# Now chain to the real entrypoint
+exec /opt/hermes/docker/entrypoint.sh "$@"

ai/patch_tts_tool.py

@@ -1,64 +1,12 @@
 #!/usr/bin/env python3
-"""Patch Hermes TTS tool to add Piper provider and remove Edge TTS fallback."""
+"""Patch Hermes TTS tool: remove Edge TTS, replace with Piper as default/fallback."""
 import sys
 
-tts_path = '/opt/hermes/.venv/lib/python3.13/site-packages/tools/tts_tool.py'
+tts_path = '/opt/hermes/tools/tts_tool.py'
 
 with open(tts_path) as f:
     code = f.read()
 
-# Replace the Coqui provider block with Piper
-old_coqui = '        elif provider == "coqui":'
-new_piper = '''        elif provider == "piper":
-            logger.info("Generating speech with Piper TTS (local, CPU)...")
-            import subprocess
-            piper_binary = "/opt/hermes/.venv/bin/piper"
-            piper_config = tts_config.get("piper", {})
-            voice = piper_config.get("voice", "en_US-lessac-medium")
-            model_dir = piper_config.get("model_dir", "/opt/hermes/.venv/share/piper/voices")
-            model_path = os.path.join(model_dir, f"{voice}.onnx")
-            if not os.path.exists(model_path):
-                raise FileNotFoundError(f"Piper voice model not found: {model_path}")
-            cmd = [piper_binary, "--model", model_path, "--output-raw"]
-            proc = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
-            raw_audio, stderr = proc.communicate(input=text.encode(), timeout=60)
-            if proc.returncode != 0:
-                raise RuntimeError(f"Piper TTS failed: {stderr.decode()[:200]}")
-            ffmpeg_cmd = ["ffmpeg", "-f", "s16le", "-ar", "22050", "-ac", "1", "-i", "-", "-y", file_str]
-            subprocess.run(ffmpeg_cmd, input=raw_audio, capture_output=True, timeout=30)
-            logger.info("Piper TTS audio saved: %s", file_str)'''
-
-if old_coqui in code:
-    code = code.replace(old_coqui, new_piper)
-    print("Coqui -> Piper replaced")
-else:
-    # Fresh Hermes install - add Piper after the last provider (kittentts)
-    if 'provider == "piper"' in code:
-        print("Piper already present, skipping coqui replacement")
-    else:
-        print("Stock Hermes - adding Piper provider after kittentts...")
-        marker = '        elif provider == "kittentts":'
-        if marker in code:
-            # Find the end of the kittentts block and insert Piper before else
-            lines = code.split('\n')
-            kit_idx = None
-            for i, line in enumerate(lines):
-                if line.strip().startswith('elif provider == "kittentts":'):
-                    kit_idx = i
-                    break
-            if kit_idx is not None:
-                # Find the next blank line + else block
-                for i in range(kit_idx, len(lines)):
-                    if lines[i].strip() == 'else:':
-                        # Insert Piper block before this line
-                        indent = '        '
-                        piper_lines = new_piper.split('\n')
-                        insert = piper_lines + ['']
-                        lines[i:i] = insert
-                        code = '\n'.join(lines)
-                        print("Piper provider added after kittentts")
-                        break
-
 # Replace the Edge fallback with Piper fallback
 old_edge = '''        else:
             # Default: Edge TTS (free), with NeuTTS as local fallback
@@ -89,8 +37,8 @@ old_edge = '''        else:
                              "or set up NeuTTS for local synthesis."
                 }, ensure_ascii=False)'''
 
-new_piper_fallback = '''        else:
+new_piper = '''        else:
-            # Default: Piper TTS (local, CPU, no cloud)
+            # Default: Piper TTS (local, CPU, no cloud, no Microsoft)
             piper_available = False
             try:
                 piper_binary = "/opt/hermes/.venv/bin/piper"
@@ -127,19 +75,20 @@ new_piper_fallback = '''        else:
                 }, ensure_ascii=False)'''
 
 if old_edge in code:
-    code = code.replace(old_edge, new_piper_fallback)
+    code = code.replace(old_edge, new_piper)
     print("Edge fallback replaced with Piper")
 else:
-    print("Edge fallback NOT found, checking if already Piper...")
     if 'Default: Piper TTS' in code:
-        print("Piper fallback already present, skipping")
+        print("Piper fallback already present")
     else:
-        print("ERROR: Could not find Edge fallback")
+        print("ERROR: Could not find Edge fallback in tts_tool.py")
-        # Debug: show what the else block looks like
+        # Debug output
         import re
-        match = re.search(r'        else:\n            # Default:', code)
+        for m in re.finditer(r'        else:\n            # Default:', code):
-        if match:
+            start = max(0, m.start() - 100)
-            print("Found else block at", match.start())
+            end = min(len(code), m.end() + 200)
+            print(f"Found else/default at position {m.start()}:")
+            print(code[start:end])
         sys.exit(1)
 
 with open(tts_path, 'w') as f:

vpn/Dockerfile

@@ -0,0 +1,16 @@
+# Custom wg-easy with iptables-nft (nftables-backed iptables)
+# Fixes crash-loop when host kernel lacks legacy iptable_nat module.
+FROM weejewel/wg-easy:latest
+
+# Alpine's iptables-nft provides iptables that uses nftables kernel API
+# instead of the legacy iptable_nat module. This works on kernels
+# where only nftables netfilter modules are available.
+RUN apk add --no-cache iptables-nft
+
+# Ensure iptables-nft takes priority over legacy iptables
+RUN ln -sf /sbin/iptables-nft /sbin/iptables && \
+    ln -sf /sbin/iptables-nft-save /sbin/iptables-save && \
+    ln -sf /sbin/iptables-nft-restore /sbin/iptables-restore && \
+    ln -sf /sbin/ip6tables-nft /sbin/ip6tables && \
+    ln -sf /sbin/ip6tables-nft-save /sbin/ip6tables-save && \
+    ln -sf /sbin/ip6tables-nft-restore /sbin/ip6tables-restore

vpn/compose.yml

@@ -2,7 +2,10 @@ version: "3.8"
 
 services:
   wireguard:
-    image: weejewel/wg-easy:latest
+    build:
+      context: ./vpn
+      dockerfile: Dockerfile
+    image: wg-easy-iptables-nft:latest
     container_name: wireguard
     cap_add:
       - NET_ADMIN