From 1cacaccca69e84ab48b084264612874d8b1adac2 Mon Sep 17 00:00:00 2001
From: 0xbyt4 <35742124+0xbyt4@users.noreply.github.com>
Date: Sun, 15 Mar 2026 11:58:48 +0300
Subject: [PATCH] fix(voice): show clear error when voice dependencies are
 missing

When PyNaCl or davey is not installed, joining a voice channel fails
with a raw exception. Now shows a human-readable message pointing
the user to reinstall with voice support.

Closes #1336
---
 gateway/run.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gateway/run.py b/gateway/run.py
index 62d1aaad..816d0f2b 100644
--- a/gateway/run.py
+++ b/gateway/run.py
@@ -2435,6 +2435,9 @@ class GatewayRunner:
         except Exception as e:
             logger.warning("Failed to join voice channel: %s", e)
             adapter._voice_input_callback = None
+            err_lower = str(e).lower()
+            if "pynacl" in err_lower or "nacl" in err_lower or "davey" in err_lower:
+                return "Voice dependencies are missing (PyNaCl / davey). Please reinstall Hermes with voice support enabled."
             return f"Failed to join voice channel: {e}"
 
         if success: