Bug: 156879015

Clone this repo:
  1. ed1d1ad Resolve security vulnerability. by jschung · 5 weeks ago main-16k-with-phones master
  2. 8373049 Merge "Using focused windows from dumpsys to verify assistant started. Test: manual - run each test case for verification. Bug: 248342160" by Zhihao Yang · 5 weeks ago
  3. c9714bd Using focused windows from dumpsys to verify assistant started. by Zhihao Yang · 9 weeks ago
  4. ffaf108 Open bugreport file in binary mode. am: 72676635ad by Zhihao Yang · 9 weeks ago
  5. 7267663 Open bugreport file in binary mode. by Zhihao Yang · 9 weeks ago

OpenHST : Open sourced Hotword Stress Test tool

Hotword stress test tool is a python script to measure the Google Hotword performance on Android devices with simple test set up. The goal of OpenHST is making Google Hotword Stress Test tool as an open source project so that Android Partners can easily adapt on their development.


Hotsord Stress Test concept diagram


Before setting up your HST test environment, please make sure to meet following preconditions.

  • DSP hotword capability on test device (android handset)
  • ADB connection between the test server and android handset
  • Internet connection on android handset
  • No screen lock setting on android handset
  • Install Homebrew (Mac)
  • Install pyenv for Linux and Mac.
  • Install GNU make(3.81 above) on test machine (Linux, Mac, Windows)

Test environment setup

Please follow below steps to set up HST on your test machine and make sure that no error popped up during the installation.

Linux & Mac

  1. pyenv install 3.6.8
  2. pyenv shell 3.6.8
  3. make start
  4. chmod +x ./start_venv.sh
  5. source env/bin/activate
  6. ./start_venv.sh
  7. make proto-compile


  1. install python3.7.5
  2. make start
  3. .\env\Scripts\activate
  4. pip3 install -r requirements.txt
  5. Download protoc.ext (3.11.4 version) from github
  6. Decompress protoc-3.11.4-win64.zip and copy bin/protoc.exe to env/ folder
  7. Decompress protoc-3.11.4-win64.zip and copy include/* under env/include folder
  8. make proto-compile

Voice model training

Before conducting stress test, voice model should be trained with the recorded tts sound.

  1. Please follow the guide in “Train voice model” chapter in OEM Hotword Stress Test with OpenHST

Note for voice match with query phrases, please use enroll_with_queries as test_name for voice match enrollment.

Stress Test

Please refer to the guide in “Run Stress Test” chapter in OEM Hotword Stress Test with OpenHST and run the hotword stress test.

  1. python stress_test.py --test_name dsp_trigger_and_screen_off --num_iterations 3000 --output_root test_out
  2. Over 95% pass ratio from 3000 test cycle would be fair enough to declare that the device passed the hotowrd stress test


Join our mailing list for discussions and announcements.