Skip to content

cengine - 1.2.0

Latest

Choose a tag to compare

@github-actions github-actions released this 07 Mar 14:55
· 3 commits to main since this release
12723f9

GitHub release
GitHub license
GitHub issues
PRs Welcome
Open Source? Yes!

CEngine Logo

CEngine

CEngine (Convert Engine) is a powerful Rust-based tool for converting Python scripts into standalone executables.

Overview

CEngine is an open-source converter that streamlines the process of creating executables from Python scripts. It handles the entire workflow automatically:

  • Creates a virtual environment
  • Analyzes and detects required packages
  • Installs dependencies
  • Builds the executable
  • Cleans up temporary files

Features

  • Smart Import Detection: Automatically scans your Python script to identify required packages
  • Virtual Environment Management: Creates and configures isolated environments for clean builds
  • Dependency Resolution: Handles package installation, including special cases like PyWin32 and OpenCV
  • Build Optimization: Creates optimized executables with minimal size
  • Automatic Cleanup: Removes temporary build files after completion
  • Cross-Platform Support: Works on Windows, macOS, and Linux
  • Debug Mode: Detailed logging for troubleshooting
  • Force Mode: Override warnings and proceed with operations

Installation

From GitHub Releases

Windows

  1. Download the latest Windows executable from the Releases page
  2. Download cengine-windows-x64.exe
  3. Add the executable to your PATH or run it directly

Linux

  1. Download the latest Linux binary from the Releases page
  2. Download cengine-linux-x64
  3. Make it executable:
    chmod +x cengine-linux-x64
  4. Move it to a directory in your PATH:
    sudo mv cengine-linux-x64 /usr/local/bin/cengine

Arch Linux (AUR)

For Arch Linux users, CEngine is available in the AUR:

Using yay

yay -S cengine

Using paru

paru -S cengine

Manual installation from AUR

git clone https://aur.archlinux.org/cengine.git
cd cengine
makepkg -si

Usage

CEngine (Convert Engine) is an open-source converter for Python to create exe from py files.

Usage: cengine <SCRIPT> [OPTIONS] [PYINSTALLER_ARGUMENTS]

Arguments:
  [SCRIPT]  Define a script to be made into an executable

Options:
  -n, --name <NAME>                Define the script name
      --add-imports <IMPORTS>...   Add more imports
      --force-platform <PLATFORM>  Add custom arguments
      --clean                      Clean failed builds
      --debug                      Sets the debug environment to true
      --force                      Forces the operation to proceed with all warnings and skippings
  -h, --help                       Print help
  -V, --version                    Print version

Basic Usage

cengine test.py
With name:
cengine test.py --name test
With custom arguments:
cengine test.py --force-platform linux --add-imports numpy
Clean failed build:
cengine test.py --name test --clean