docs: clarify PyPI installation requirements (#423)

2026-05-06 23:00:01 -07:00
parent ff9fd0a961
commit c0246d5fc8
3 changed files with 143 additions and 15 deletions
@@ -84,11 +84,20 @@ jobs:
            ./install.sh
            ```

-            ### From PyPI (if available)
+            ### From PyPI
            ```bash
+            # Install the Linux system packages first:
+            # GTK/AppIndicator, PortAudio, and xdotool/wtype are required.
+            python3 -m venv ~/.local/share/vocalinux-pypi/venv --system-site-packages
+            source ~/.local/share/vocalinux-pypi/venv/bin/activate
            pip install vocalinux
+            vocalinux
            ```

+            PyPI installs the Python package only. For automatic system dependency,
+            desktop integration, and model setup, use the Quick Install command above.
+            See docs/INSTALL.md for distro-specific PyPI prerequisites.
+
            ---
            See [CHANGELOG](https://github.com/jatinkrmalik/vocalinux/releases) for detailed changes.