pyfuze 0.6.3

pyfuze makes your Python project run anywhere

pyfuze

description

pyfuze makes your Python project run anywhere.

install

pip install pyfuze

usage

Usage: pyfuze [OPTIONS] PYTHON_PROJECT

  pyfuze — package Python scripts with dependencies.

Options:
  --python TEXT                   Add .python-version file
  --reqs TEXT                     Add requirements.txt file (input comma-
                                  separated string OR requirements.txt path)
  --pyproject FILE                Add pyproject.toml file
  --uv-lock FILE                  Add uv.lock file
  --entry TEXT                    Entry python file
  --include TEXT                  Include additional file or folder
                                  (source[:destination]) (repeatable)
  --exclude TEXT                  Exclude path relative to the project root
                                  (repeatable)
  --env TEXT                      Add environment variables (key=value)
                                  (repeatable)
  --win-gui                       Hide the console window on Windows
  --uv-install-script-windows TEXT
                                  UV installation script URI for Windows
                                  [default: https://astral.sh/uv/install.ps1]
  --uv-install-script-unix TEXT   UV installation script URI for Unix
                                  [default: https://astral.sh/uv/install.sh]
  -d, --debug                     Enable debug logging
  -v, --version                   Show the version and exit.
  -h, --help                      Show this message and exit.

example

pyfuze ./examples/ip.py --python 3.8 --reqs requests --win-gui

This command will generate dist/ip.zip which contains:

• pyfuze.com
• .python-version ("3.8")
• requirements.txt ("requests")
• src/ip.py
• config.txt (2 lines: "entry=ip.py" "win_gui=1")

pyfuze.com is an Actually Portable Executable, capable of running natively on Linux, macOS, Windows, FreeBSD, OpenBSD, NetBSD, and BIOS across both AMD64 and ARM64 architectures.

Executing pyfuze.com will do the following:

• install uv in ./uv folder
• install python in ./python (version: .python-version)
• install dependencies in requirements.txt
• run the Python project

Note: uv primarily supports macOS (both Apple Silicon and x86_64), Linux (x86_64), and Windows (x86_64).