Skip to content

For AI beginners, deploying AI software from source code can be challenging. With a bundle, you just need to download, extract, and double-click to use it, greatly lowering the barrier to entry. However, sometimes you may not find a ready-made bundle, or the bundle is not updated in time. In such cases, you can try creating your own bundle and share it with others.

Since AI project models are usually large, and with GPU support, even when compressed into 7z format, the file size may far exceed 5GB, making it difficult to upload to cloud storage or store. Therefore, I will no longer create bundles. If you are interested, you can follow this tutorial to make your own bundle and share it with others.

This tutorial uses F5-TTS as an example to create a bundle on Windows 10 with Python 3.10. The main steps are:

  1. Download Python 3.10 embed version (not the exe installer, but a zip package).
  2. Install pip and set the dependency search path for the project.
  3. Download F5-TTS source code.
  4. Install F5-TTS dependency modules.
  5. Create a one-click startup script and set the model directory to the project directory.
  6. Configure a proxy to download models.
  7. Perform one cloning task to complete the download of other models like Whisper.
  8. Compress into a bundle.
  9. Create bundles for other AI projects.

Preparation Before Starting:

First, create an empty folder. To avoid errors, it is recommended to create an English-named folder on a non-system drive, such as D:\f5win. This article uses D:\f5win as an example. Then, create another empty folder runtime inside it to store the Python 3.10 embed version files to be downloaded later.

Before starting, be sure to click "View" in the folder navigation bar and check "File name extensions." Otherwise, subsequent operations may easily go wrong, especially for those unfamiliar with file extensions.

Show File Extensions


1. Download Python 3.10 Embed Version

Important: Here, you download the embed version, not the exe installer. This version does not depend on your local Python environment; even if you already have Python installed, you still need to download this version.

  • Download link: https://www.python.org/downloads/release/python-31011/

  • After opening the webpage, scroll to the bottom and click Windows embeddable package (64-bit) to download. You will get a zip package.

    Download Python Embed Version

    Be sure to download this version; do not get it wrong!

  • After downloading, extract the zip package and copy all the files inside to the previously created runtime folder. As shown below:

    Copy Python Embed Files to Runtime Folder


2. Install pip and Modify Package Search Path

The embed version of Python does not include the pip module, so it needs to be installed manually.

  • Install pip:

    • Open this address: https://bootstrap.pypa.io/get-pip.py

    • Right-click and save the file to the runtime directory. After saving, there should be a file named get-pip.py in the runtime folder.

      Download get-pip.pyget-pip.py Fileget-pip.py in Runtime Directory

    • In the address bar of the runtime folder, type cmd and press Enter to open a terminal window (black window).

      Open cmd and Confirm Path is in Runtime

    • In the terminal window, enter the command .\python get-pip.py and press Enter. Be sure to note whether the current folder address displayed in the command line is inside the runtime folder; otherwise, errors may occur.

      Wait for the installation to complete...

      pip Installing

      The pip module is successfully installed!

      pip Module Installed Successfully

  • Modify the python310._pth file:

    • In the runtime folder, find the file named python310._pth, right-click and open it with Notepad.

      Default Content in python310._pth File

    • Below the dot . on the second line, add the following three lines:

      ./Lib/site-packages
      ../src
      ../src/f5_tts
    • Save the file. The modified file content should look like the following; please check carefully to ensure it is correct:

      Modified python310._pth File Content Should Be As Follows


3. Download F5-TTS Source Code

  • Open the F5-TTS project GitHub repository: https://github.com/SWivid/F5-TTS

  • Download the source code zip package.

    Download F5-TTS Source Code

  • Extract the downloaded zip package and copy all files from the F5-TTS-main folder to the D:\f5win folder. Note: Copy the files inside, not the entire F5-TTS-main folder.

    Copy Files from F5-TTS-main

    After extraction, the contents of the D:\f5win folder should look like the following:

    Correct Directory Structure of D:5win After Copying


Return to the Previous CMD Window

Still in the same terminal window, execute the cd ../ command to ensure the address in the command line no longer includes runtime, as shown below. All subsequent operations should be performed in the D:/f5win directory.

4. Install Dependency Modules

  • Return to the cmd terminal window and confirm again that the current path displayed is D:\f5win (without runtime).

  • Execute the following command to install dependencies (note the spaces and dot):

    .\runtime\python -m pip install -e .

    Installing Dependencies

    Wait for the installation to complete...

All Dependencies Installed

  • If you want the bundle to support NVIDIA GPUs (optional): Continue by executing the following command to install the CUDA version of PyTorch and torchaudio (note the spaces and dot; the command should not be line-wrapped):
    .\runtime\python -m pip install torch==2.4.0+cu124 torchaudio==2.4.0+cu124 --extra-index-url https://download.pytorch.org/whl/cu124

5. Create a One-Click Startup Script

By default, models are saved to the user directory on the C drive. For easier bundling, we need to download models into the bundle directory.

  • In the D:\f5win folder, right-click -> New -> Text Document to create a run.txt file. Open it with Notepad and enter the following code:

```bat
@echo off

chcp 65001 > nul

set "HF_HOME=%~dp0models"
set "MODELSCOPE_CACHE=%~dp0models"

echo HF_HOME: %HF_HOME%
echo MODELSCOPE_CACHE: %MODELSCOPE_CACHE%

"%~dp0runtime\python" -m f5_tts.infer.infer_gradio  --inbrowser

pause
```

The above script means: save models to the models folder in the current directory, then start the web interface and automatically open it in the browser.

  • After saving the file, rename run.txt to run.bat. A warning will pop up; select "Yes." If no warning appears, you made an error in modification; check if file extensions are displayed.

    Warning Popup When Renaming to run.bat


6. Configure Proxy Environment

Due to restrictions in the domestic network environment, you cannot directly access Hugging Face (huggingface.co), where F5-TTS models are hosted. Therefore, you need to configure a proxy and set it as the system proxy.

For example, if using v2ray, you can set it as follows:

Set as System Proxy in v2ray

After configuration, double-click the previously created run.bat file.

  • If double-clicking opens the file directly with Notepad, it means you failed to change the extension. Please return to the preparation section at the top of this article and follow the instructions to enable file extensions.

  • If double-clicking opens a black window, it will start downloading models to the D:\f5win\models folder.

    Downloading Models

  • If an error similar to the following appears, it means you have not configured the proxy properly or set it as the system proxy, preventing connection to Hugging Face to download models.

    Model Download Error: Unable to Connect to huggingface.co

    Sometimes the download fails halfway through, mostly due to unstable proxy nodes. Please switch to a more stable proxy or node.

  • After the models are downloaded, the browser window will open automatically. Models Downloaded, Browser Opens Automatically


7. Perform One Cloning Task to Download Whisper Model

During voice cloning, if no text corresponding to the reference audio is provided, F5-TTS will automatically download the Whisper model from Hugging Face. To ensure the bundle is complete, we need to download it in advance.

  • In the automatically opened web window, select a clean 5-10 second reference audio, enter the text you want to synthesize (e.g., "Hello friend"), and click "Synthesize."

    Web Interface

  • This will start downloading the Whisper model.

    Downloading Whisper Model

  • When synthesis is successful and no errors occur, you can start packaging the project into a bundle.


8. Compress into a Bundle

  • Before compression, you can rename run.bat to Click to Start.bat to make it easier for novice users to understand.
  • Compress the entire D:\f5win folder into a zip file, or into a smaller 7z file.
  • Share the compressed package with others; they can extract it and double-click run.bat (or Click to Start.bat) to use it.


9. How to Create Bundles for Other AI Projects

Most open-source Python-based projects on GitHub can use a similar method to create bundles. The main differences lie in the following three points:

  1. Python Version: Python 3.10 is the most universal version, suitable for most projects. If a project has special requirements (e.g., 3.11 or 3.12), you can find the corresponding version's Windows embeddable package (64-bit) on this page: https://www.python.org/downloads/windows/. Be sure not to download the exe installer.

  2. Content of the python310._pth file:

    • ./Lib/site-packages is still necessary to add.
    • Other paths should be added based on the actual project structure.
    • If the project has a code directory named cfg, add a line ../cfg.
    • If the project has a src directory with other folders inside, continue adding ../src/folder_name.
  3. Startup Command in the run.bat Script:

    • Only this line needs to be modified:
      "%~dp0runtime\python" -m f5_tts.infer.infer_gradio  --inbrowser
    • The "%~dp0runtime\python" part remains unchanged; the rest should be replaced with the corresponding project's startup command (excluding python).
    • If in doubt, provide the content of run.bat and the startup command of the corresponding project to an AI and ask it to generate a new startup script based on run.bat. Remember to tell the AI to use the Python interpreter from run.bat.