hermes - 💡(How to fix) Fix Desktop app crashes on macOS: findSystemPython() picks Python 3.9 from /usr/bin, fails on str | None syntax

 The Hermes Desktop app crashes on macOS when the system Python at /usr/bin/python3 is version 3.9.x (which is      
 the default on macOS). The error occurs because hermes_cli/main.py uses PEP 604 type union syntax (str | None)     
 which requires Python 3.10+.                                                                                       
 Error                                                                                                              
                                                                                                                    
 [hermes] [boot] Using installed hermes_cli module via /usr/bin/python3                                             
 [hermes] File "/Users/.../.hermes/hermes-agent/hermes_cli/main.py", line 207, in <module>                          
 [hermes] def _read_openai_version_fast() -> str | None:TypeError: unsupported operand type(s) for : 'type' and     
 'NoneType'                                                                                                         
 [hermes] Hermes backend exited (1).                                                                                
                                                                                                                    
 Root Cause                                                                                                         
                                                                                                                    
 In apps/desktop/electron/main.cjs, the findSystemPython() function on POSIX systems does a simple PATH lookup:     
                                                                                                                    
 js                                                                                                                 
 function findSystemPython() {                                                                                      
   if (!IS_WINDOWS) {                                                                                               
     for (const command of ['python3', 'python']) {                                                                 
       const candidate = findOnPath(command)                                                                        
       if (candidate) return candidate                                                                              
     }                                                                                                              
     return null                                                                                                    
   }                                                                                                                
   // ...Windows has version filtering (SUPPORTED_VERSIONS = ['3.11', '3.12', '3.13'])                              
 }                                                                                                                  
                                                                                                                    
 When launched from Finder/Dock (not terminal), macOS gives GUI apps a minimal PATH where /usr/bin comes before     
 /usr/local/bin. So /usr/bin/python3 (Python 3.9.6) is found first, even though /usr/local/bin/python3 (3.14.5)     
 or /opt/homebrew/bin/python3 is available.                                                                         
                                                                                                                    
 The Windows branch already filters by SUPPORTED_VERSIONS = ['3.11', '3.12', '3.13'], but the POSIX branch has      
 no version check at all.                                                                                           
 Suggested Fix                                                                                                      
                                                                                                                    
 Add Python version checking on POSIX similar to Windows. The findSystemPython() function should:                   
                                                                                                                    
 1. Check well-known macOS locations (/usr/local/bin, /opt/homebrew/bin) in addition to PATH                        
 2. Verify the candidate Python is >= 3.10 before returning it                                                      
 3. Fall through to bootstrap if no suitable Python is found                                                        
                                                                                                                    
 js                                                                                                                 
 function isPythonAtLeast310(pythonPath) {                                                                          
   try {                                                                                                            
     const { execFileSync } = require('child_process')                                                              
     const out = execFileSync(pythonPath, [                                                                         
       '-c', 'import sys; print(".".join(map(str, sys.version_info[:2])))'                                          
     ], { timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).toString().trim()                                       
     const [major, minor] = out.split('.').map(Number)                                                              
     return major > 3 || (major === 3 && minor >= 10)                                                               
   } catch { return false }                                                                                         
 }                                                                                                                  
                                                                                                                    
 Environment                                                                                                        
                                                                                                                    
 - OS: macOS (Apple Silicon)                                                                                        
 - Hermes version: latest (installed via DMG)                                                                       
 - System Python: /usr/bin/python3 = 3.9.6                                                                          
 - User Python: /usr/local/bin/python3 = 3.14.5                                                                     
 Workaround                                                                                                         
                                                                                                                    
 Launch from terminal with corrected PATH:                                                                          
 bash                                                                                                               
 PATH=/usr/local/bin:$PATH open ~/.hermes/hermes-agent/apps/desktop/release/mac-arm64/Hermes.app