PyOxidizer

PyOxidizer is a utility that aims to solve the problem of how to distribute Python applications. See Overview for more or dive into Getting Started to learn how to start using PyOxidizer.

The official home of the PyOxidizer project is https://github.com/indygreg/PyOxidizer. Official documentation lives at https://pyoxidizer.readthedocs.io/en/latest/index.html.

The pyoxidizer-users mailing list is a forum for users to discuss all things PyOxidizer.

If you want to financially contribute to PyOxidizer, do so on Patreon or via PayPal.

The creator and maintainer of PyOxidizer is Gregory Szorc.

• Overview
  • Benefits of PyOxidizer
  • Components
  • How It Works
• Getting Started
  • Installing
  • Your First PyOxidizer Project
  • Customizing Python and Packaging Behavior
• Managing Projects with pyoxidizer
  • High-Level Project Lifecycle and Pipeline
  • Creating New Projects with init
  • New Project Layout
  • Adding PyOxidizer to an Existing Project with add
  • Building PyObject Projects with build
  • Running Applications with run
  • Analyzing Produced Binaries with analyze
  • Inspecting Python Distributions
• Packaging User Guide
  • Creating a PyOxidizer Project
  • Packaging an Application from a PyPI Package
  • What Can Go Wrong
  • Packaging Additional Files
  • Trimming Unused Resources
• Packaging Pitfalls
  • Reliance on __file__
  • Resource Reading
  • C and Other Native Extension Modules
• Distributing Binaries
  • Binary Compatibility
  • Licensing Considerations
• Configuration Files
  • Finding Configuration Files
  • File Processing Semantics
  • Configuration Sections
• Frequently Asked Questions
  • Where Can I Report Bugs / Send Feedback / Request Features?
  • Why Build Another Python Application Packaging Tool?
  • Can Python 2.7 Be Supported?
  • No python interpreter found of version 3.* Error When Building
  • Why Rust?
  • Why is the Rust Code… Not Great?
  • What is the Magic Sauce That Makes PyOxidizer Special?
  • Can Applications Import Python Modules from the Filesystem?
  • What are the Implications of Static Linking?
• Project Status
  • What’s Working
  • Major Missing Features
  • Lesser Missing Features
  • Eventual Features
• Comparisons to Other Tools
  • PyInstaller
  • py2exe
  • py2app
  • cx_Freeze
  • Shiv
  • PEX
  • XAR
  • Docker / Running a Container
  • Nuitka
  • PyRun
  • pynsist
• Contributing to PyOxidizer
  • As a User
  • As a Developer
  • Financial Contributions
• Project History
  • Blog Posts
  • Version History
• pyembed Crate
  • Dependencies
  • Features
  • Technical Implementation Details
  • Packed Modules Data
  • Packed Resources Data
• Technical Notes
  • CPython Initialization
  • CPython Importing Mechanism
  • sys.modules After Interpreter Init
  • Modules Imported by site.py
  • Random Notes