PY to EXE Online Converter

Convert Python files to Windows executable files online using GitHub Actions.

Features

• 🚀 Free and open source
• 🔒 Secure conversion process
• ⚡ Fast conversion using GitHub Actions
• 📦 No installation required
• 🎯 Simple drag-and-drop interface
• 🧹 Automatic cleanup of source files

Architecture

This project uses a two-repository architecture:

1. Web Interface Repository (SymphonyIceAttack/pytoexe)

   • Next.js web application
   • Handles file uploads and status tracking
   • User interface for conversion process

2. Processing Repository (SymphonyIceAttack/pytoexe-use)

   • GitHub Actions workflow
   • PyInstaller conversion process
   • File storage and artifact management

How It Works

1. Upload - Drag and drop your .py file or click to select

2. Convert - GitHub Actions automatically processes your file with PyInstaller

3. Download - Get your .exe file from GitHub Actions artifacts

4. User uploads a .py file through the web interface (this repository)

5. Web app uploads the file to the processing repository via GitHub API

6. GitHub Actions workflow in processing repository automatically triggers

7. PyInstaller converts the Python file to an executable

8. Converted file is available as an artifact

9. Original Python file is automatically deleted from processing repository

Setup

This project requires a GitHub repository with Actions enabled. See SETUP_INSTRUCTIONS.md for detailed setup steps.

Quick Setup

1. Create a GitHub repository
2. Add your own GitHub Actions workflow file at .github/workflows/convert.yml with PyInstaller
3. Create a GitHub personal access token with repo and workflow scopes
4. Configure environment variables:
   • GITHUB_TOKEN - Your personal access token
   • GITHUB_OWNER - Your GitHub username
   • GITHUB_REPO - Your processing repository name

Environment Variables

Variable	Description	Example
GITHUB_TOKEN	Personal access token	ghp_xxxxxxxxxxxx
GITHUB_OWNER	GitHub username	SymphonyIceAttack
GITHUB_REPO	Processing repository name	pytoexe-use

Important: GITHUB_REPO should be your processing repository (e.g., pytoexe-use), not the web interface repository.

Technology Stack

• Frontend: Next.js 16, React 19, TypeScript, Tailwind CSS
• Backend: GitHub Actions, PyInstaller
• Deployment: Vercel

Security

• All Python files are processed in GitHub Actions (isolated environment)
• Source files are automatically deleted after conversion
• No files are stored permanently on our servers
• Open source - you can review all code

License

MIT License - feel free to use and modify

Support

For issues or questions:

• Check the Setup Instructions
• Review GitHub Actions logs in your repository
• Open an issue on GitHub

---

Repositories:

• Web Interface: github.com/SymphonyIceAttack/pytoexe
• Processing: github.com/SymphonyIceAttack/pytoexe-use

Powered by GitHub Actions and Vercel