Skip to main content

​
Welcome to Windows Python Launcher

A powerful yet simple batch script that streamlines Python project execution on Windows. Perfect for testing and distributing Python projects without the complexity of compilation or packaging.

Quick Start

Get up and running in minutes with our step-by-step guide

Configuration Guide

Customize the launcher to fit your project’s needs

Usage Examples

Learn different ways to run your Python scripts

Troubleshooting

Solutions to common issues and problems

​
Key Features

Python Detection

Automatically detects installed Python versions and supports the py launcher

Virtual Environments

Optional automatic venv creation and activation for isolated dependencies

Auto Dependencies

Automatically installs requirements.txt when creating virtual environments

Smart File Detection

Auto-detects and runs common entry points like run.py, main.py, and app.py

Drag & Drop

Simply drag and drop Python files onto the script to execute them

Portable Support

Works with portable Python installations for maximum flexibility

​
Perfect For

Quickly test Python projects without manual environment setup. Simply run the batch file and let it handle Python detection, venv creation, and dependency installation.
Include the launcher with your Python project to give users a one-click way to run your application without needing to understand virtual environments or package management.
Create multiple copies of the launcher with different configurations for various projects or testing scenarios. Each launcher can have its own Python version, venv name, and settings.
Perfect for students and educators who need a simple way to run Python code without dealing with command-line complexity or environment management.

​
Getting Started

1

Download the Script

Download PythonLauncher.bat from the GitHub repository
2

Configure for Your Project

Edit the configuration variables at the top of the batch file to customize behavior
3

Run Your Python Code

Double-click the launcher or drag-and-drop a Python file onto it

View on GitHub

Star the repository and contribute to the project