TanixLu

pyfuze: Package Python Projects as Executables with Cosmopolitan

pyfuze packages Python projects into a single executable, built on Cosmopolitan and Astral's uv. Choose same-platform bundles or cross-platform online and portable modes targeting macOS, Linux, and Windows.

View on GitHub Compare
Stars
888
Forks
54
Stars, last 30 days
+0
Last commit
1.1 years ago
Contributors
1

Our take

Inactiveno commits in over a year

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

pyfuze offers three practical packaging trade-offs, but its inactive status and reliance on one contributor make it a cautious choice for new production dependencies.

Good fit if

  • You need one of its clearly differentiated bundle, online, or portable packaging modes.
  • Your project fits the chosen mode's platform, internet, and dependency constraints.
  • You are comfortable evaluating an MIT-licensed tool whose latest commit is over a year old.

Look elsewhere if

  • Your project needs active maintenance or a broader contributor base: most of the code comes from one person, with no recent issue closures or merged pull requests reported.
  • You need portable mode for native or otherwise non-pure-Python dependencies.
  • Your users cannot rely on internet access and you need cross-platform packaging, since bundle mode only runs on the platform where it was packaged.
All health signals
Last commit2025-09-18 (1.1 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age18 months

Checked on 2026-10-16 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

889

Forks

54

Change since Nov 17, 2026: 0 stars·0 forks

Overview

pyfuze packages a Python project into a single executable, building on Cosmopolitan and Astral's uv. It is for developers who want to distribute an application without asking users to set up its Python environment themselves. The bundle mode favors compatibility on the build platform; online and portable modes target macOS (ARM64 and AMD64), Linux (AMD64), and Windows (AMD64).

The modes trade package size and runtime requirements against compatibility: bundle includes Python and dependencies, online downloads them when launched, and portable works offline without extraction but supports only pure-Python projects and dependencies.

Key Features

  • Packages a Python file or project folder into an executable.
  • Bundle mode includes Python and dependencies for use on the same platform where it was packaged.
  • Online mode creates a smaller cross-platform package that downloads Python and dependencies at runtime.
  • Portable mode creates a standalone executable without extraction or an internet connection, for pure-Python projects and dependencies.
  • Accepts dependency inputs through requirements, pyproject.toml, and uv.lock options.
  • Supports including and excluding project files, choosing an entry file, and setting the runtime extraction path.
  • Offers options for Windows GUI applications, environment variables, and custom uv installation script URLs.

Use Cases

  • A Python developer distributing a dependency-heavy application to users on the same operating system can use bundle mode to include its runtime and dependencies.
  • A team that wants smaller packages for several supported platforms, and can rely on users having internet access at launch, can choose online mode.
  • Someone sharing a simple script with pure-Python dependencies can try portable mode for an offline, standalone executable.
  • An application maintainer can include configuration files and set a persistent extraction location when runtime files need to survive beyond a temporary directory.

What you need

Detected in the repository

  • Python >=3.8 (from pyproject.toml)
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI and consult the README for mode details and examples:

pip install pyfuze

Considerations

The project is marked inactive, with no commits in over a year and no release in the past year. Its contributor base is concentrated in one person, and the measured data reports no recent issue closures or merged pull requests. Teams adopting it should account for the possibility that fixes or compatibility updates may not arrive promptly.

Portable mode is limited to pure Python and uses a Python 3.12.3 base. Online mode requires internet access at runtime, while bundle mode is not cross-platform. The README also states that pyfuze does not encrypt or obfuscate code, so packaging should not be treated as source-code protection.

Found this useful?

Share it with someone who would like pyfuze.