🚀 Universal GitHub Player

[UA] Універсальний лаунчер для запуску будь-яких Python-проєктів з GitHub в один клік.
[EN] A universal launcher to run any Python project from GitHub with a single click.

---

⚡ Що це таке? / What is it?

🇺🇦 Українською:

Ця програма дозволяє запускати скрипти з GitHub без необхідності встановлювати Python на комп'ютер.

• Portable Engine: Програма сама завантажує ізольовану версію Python (~25MB).
• Auto-Install: Автоматично розпаковує репозиторій та встановлює залежності (requirements.txt).
• Smart Launch: Сама знаходить вхідну точку (main.py, bot.py тощо) та запускає її у вбудованому терміналі.

---

🇺🇸 English:

This tool allows you to run GitHub scripts without manually installing Python or managing environments.

• Portable Engine: Automatically downloads an isolated Python environment (~25MB).
• Auto-Install: Unpacks the repository and installs dependencies from requirements.txt.
• Smart Launch: Detects the entry point (main.py, bot.py, etc.) and executes it in the built-in terminal.

---

🚀 Швидкий старт / Quick Start

1. Завантажте GitHubPlayer.py та install.bat.
2. Запустіть install.bat. Він встановить customtkinter та інші модулі, необхідні для роботи інтерфейсу.
3. Вставте посилання на будь-який GitHub репозиторій.
4. Натисніть PLAY / RUN.

---

🛠 Технології / Tech Stack

• GUI: CustomTkinter (Modern UI)
• Engine: Python Embeddable (isolated environment)
• Automation: Subprocess, Threading, ZipFile

---

📝 GitHub Setup (About & Topics)

Description: 🚀 Universal GitHub Player: Run any Python project from GitHub with one click. Isolated environment, auto-dependency management, and built-in terminal.

Topics: github-launcher, portable-python, automation, gui, customtkinter, script-executor, developer-tools