Skip to content

1.0.0

Choose a tag to compare

@MrBooks36 MrBooks36 released this 13 Aug 05:57
· 187 commits to main since this release

PyCompyle v1.0.0 – Initial Release
Released: August 13, 2025
Author: MrBooks36


What is PyCompyle?

PyCompyle is a lightweight Python packaging tool designed to convert .py scripts into standalone .exe files. It offers advanced control over how the build is generated, what files are included, and how the output behaves.


Key Features in v1.0.0

  • Package any .py file into a .exe
  • Defender-friendly builds — avoids typical false-positive triggers.
  • Optional icon injection (--icon) for a professional appearance.
  • Force UAC elevation prompt with --uac.
  • Support for GUI apps via --windowed mode (no console window).
  • Custom post-processing:
  • Copy arbitrary files/folders into the build dir (--copy).
  • Auto-resolves local and standard library imports.
  • Manual override support for missed packages (--package).
  • linked_imports.json support with optional --force-refresh.
  • Option to preserve intermediate build files (--keepfiles).
  • Debugging & diagnostics:
    • Verbose mode (--verbose)
    • Debug mode (--debug) = verbose + keep files - windowed
  • Clean CLI interface (python -m PyCompyle)

Example Command

python -m PyCompyle --force-refresh --icon="myicon.ico" --verbose --windowed --package=numpy --package=ollama my_script.py


Known Limitations

  • No support for one folder builds (yet).
  • PyPy is not supported.

🔮 Roadmap (Future Plans)

  • --onefolder flag to build into a folder not a standalone exe
  • PyPy runtime embedding

Bug Reporting & Contributions

Found a bug? Import not detected?
Submit an issue at: https://github.com/MrBooks36/PyCompyle/issues


📝 License

BSD 3-Clause License – See LICENSE.md for full terms.
(c) 2025 MrBooks36. All rights reserved.