Building a .pypkg Package Runner for Windows with Python 3.14 / 3.8 Auto-Selection

Amir mohamad — Wed, 23 Sep 2026 13:07:18 +0000

Hey devs! 👋

I recently built Python EnterPlase — a small PyQt5 desktop application
for Windows that runs .pypkg package files. I want to share what it does
and the interesting technical challenges I ran into.

The Problem

When you want to distribute a Python-based installer, you usually tell users:

"First install Python 3.x, then run these commands..."

This is fine for developers, but for non-technical users, it's a pain.

The Solution

Python EnterPlase handles this automatically. You give it a .pypkg file —
a simple text file with a header and a list of shell commands — and it:

Detects your Windows version
- Windows 10/11 → uses Python 3.14
- Windows 8.1 and below → uses Python 3.8
Prefers an already-installed Python
- Checks py -3.XX launcher
- Checks C:\PythonXXX\, Program Files, %LOCALAPPDATA%\Programs\Python
- Checks PATH
- Only downloads the official embeddable package if nothing is found
Blocks dangerous commands
- Registry edits (reg add, regedit)
- Disk operations (format, diskpart)
- bcdedit, vssadmin, net user, sc create, and more
- With 3 layers of protection: preview, confirmation dialog, runtime block
Shows everything before running
- Developer name
- SHA256 / SHA1 hashes (with copy button)
- Plain-English description of every command

The .pypkg Format

It's just plain text:

Commander:cmd
Developer:YourName
DS:pip,storage
SHA256:pass
SHA1:pass
pip install --upgrade pip
pip install ursina
python "C:/install.py"
=END=

Technical Challenges

1. Running commands safely on Windows

Early versions used shell=True with a string command. This broke with
quoted paths. The fix was to build the command as a list and pass it
directly to subprocess.run: