diff --git a/.github/workflows/node-hub-ci-cd.yml b/.github/workflows/node-hub-ci-cd.yml
index d4040ff9..1835f8b9 100644
--- a/.github/workflows/node-hub-ci-cd.yml
+++ b/.github/workflows/node-hub-ci-cd.yml
@@ -48,6 +48,16 @@ jobs:
           git submodule update --init --recursive
           git submodule update --remote --recursive
 
+      - name: Install system-level dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get install portaudio19-dev
+
+      - name: Install system-level dependencies for MacOS
+        if: runner.os == 'Mac' || github.event_name == 'workflow_dispatch' || (github.event_name == 'release' && startsWith(github.ref, 'refs/tags/'))
+        run: |
+          brew install portaudio
+
       - name: Free Disk Space (Ubuntu)
         uses: jlumbroso/free-disk-space@main
         if: runner.os == 'Linux'
diff --git a/node-hub/dora-pyaudio/README.md b/node-hub/dora-pyaudio/README.md
index afc5c15a..f8d13b59 100644
--- a/node-hub/dora-pyaudio/README.md
+++ b/node-hub/dora-pyaudio/README.md
@@ -2,6 +2,18 @@
 
 ## Getting started
 
+- (MacOS) Install `portaudio`
+
+```bash
+brew install portaudio
+```
+
+- (Linux) Install `portaudio`
+
+```bash
+sudo apt-get install portaudio19-dev python-all-dev
+```
+
 - Install it with pip:
 
 ```bash