This guide will walk you through setting up a Virtual Python Environment (venv) to run the LipTalk Audio Converter directly from the source code. This is the required method for macOS/Linux users and developers.
requirements.txt is mandatory if you plan to compile the script into a standalone executable (using PyInstaller or Nuitka). Different versions of PyTorch or other dependencies are known to cause significant packaging errors and broken binaries. While a standard venv might run with newer versions, successful compilation only works with the specified requirements.
Please execute the following commands within the liptalk_converter_resource_files directory:
1. Create the Environment (using 3.11):
py -3.11 -m venv venv
2. Activate the Environment:
venv\Scripts\activate
3. Install Project Dependencies:
python -m pip install .
4. Run the Script:
python liptalk_converter_2026.py
1. Create the Environment (using 3.11):
python3.11 -m venv venv
2. Activate the Environment:
source venv/bin/activate
3. Install Project Dependencies:
python3 -m pip install .
4. Run the Script:
python3 liptalk_converter_2026.py
pip install . fails, use the requirements file directly while the venv is active:pip install -r requirements.txtpip3 install -r requirements.txt
liptalk_converter_2026.py: Main Python source code (GUI & Logic).requirements.txt: Mandatory versions for Torch, Allosaurus, etc.setup.py: Script to automate the local installation process.icon/: Directory containing visual assets.