Problem

hermes update fails on Android/Termux (aarch64, Python 3.13) because pip install -e ".[all]" hits transitive dependencies without wheels:

The update process crashes during dependency resolution and the user is left with a broken installation.

Solution

Runtime detection in hermes_cli/main.py:

• New _android_excluded_extras() function checks sys.platform == "android" and returns the set of incompatible extras
• _install_python_dependencies_with_optional_fallback() uses this to build a filtered extras string instead of .[all] on Android
• The individual-extras fallback loop also skips excluded extras

Defense in depth via pyproject.toml:

• Added sys_platform != "android" markers to voice extra dependencies

Changes

• hermes_cli/main.py: +42 lines (new function + integration in install flow)
• pyproject.toml: +2 markers on voice deps

Testing

Tested on:

• Device: Nothing Phone 2, Android 16
• Environment: Termux 0.119.0-beta.3, Python 3.13.13
• pip install --dry-run with filtered extras → exit 0, 128 packages resolved
• hermes update completes successfully
• hermes --version → v0.11.0 ✓

Impact

• Zero impact on non-Android platforms: _android_excluded_extras() returns set() when sys.platform != "android"
• No new dependencies
• Minimal code footprint: single function + 2 integration points
• Graceful degradation: if filtered install fails, falls back to base + individual extras (which also skip incompatible ones)