██████╗ ██╗████████╗██╗ ██╗██╗ ██╗██████╗ ██████╗ ██████╗ ██████╗ ██╗███████╗ ██████╗████████╗ ██╔════╝ ██║╚══██╔══╝██║ ██║██║ ██║██╔══██╗ ██╔══██╗██╔══██╗██╔═══██╗ ██║██╔════╝██╔════╝╚══██╔══╝ ██║ ███╗██║ ██║ ███████║██║ ██║██████╔╝ ██████╔╝██████╔╝██║ ██║ ██║█████╗ ██║ ██║ ██║ ██║██║ ██║ ██╔══██║██║ ██║██╔══██╗ ██╔═══╝ ██╔══██╗██║ ██║██ ██║██╔══╝ ██║ ██║ ╚██████╔╝██║ ██║ ██║ ██║╚██████╔╝██████╔╝ ██║ ██║ ██║╚██████╔╝╚█████╔╝███████╗╚██████╗ ██║ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚════╝ ╚══════╝ ╚═════╝ ╚═╝
Multi‑language project launcher with built‑in security analysis, smart caching, virtual environments, and Arabic/English interface.
Educational tool – run only code you trust.
This is a command‑line wizard that takes any GitHub URL – a raw Python file or a full repository – and automates the entire process of:
- ✅ Cloning (with smart caching)
- ✅ Security scanning (detects dangerous calls like
exec,os.system) - ✅ Automatic dependency detection & installation (supports
requirements.txt,Pipfile,pyproject.toml, and heuristics) - ✅ Creating an isolated virtual environment (venv) for safety
- ✅ Running the project – even for Node.js, Ruby, Go, Rust projects!
- ✅ Bilingual interface (Arabic 🇸🇦 / English 🇬🇧) – switch anytime
# 1. Clone the runner itself
git clone https://github.com/Ali-Haidar-Sy/GitHub-Project-Runner.git
cd GitHub-Project-Runner
# 2. No external dependencies required – just Python 3!
python runner.py
Then paste any GitHub URL. The script will guide you in your chosen language.
📦 Features at a Glance
Feature Description
Raw file execution Paste a raw.githubusercontent.com/... link to download and run directly
Repository cloning Clones full GitHub repos and attempts to run them intelligently
Smart caching Already-cloned repos are stored locally – next time, ask if you want fresh or cached version
Multi‑language support Detects Python, Node.js, Ruby, Go, Rust projects and runs them with the correct tooling
Auto‑dependency install Scans requirements.txt, Pipfile, pyproject.toml, or crawls the source code for imports
Virtual environment Optionally create an isolated venv before installing packages
Security scanner Parses Python AST to warn you about dangerous functions before execution
Bilingual interface Choose Arabic or English at startup and switch anytime
🧠 How It Works (Internal Flow)
URL parsing – determines if the input is a raw Python file or a GitHub repository.
Clone / Download – clones the repo (with cache check) or downloads the single file.
Project type detection – scans for package.json, Gemfile, go.mod, Cargo.toml, requirements.txt, etc.
Security scan – walks the AST of every .py file looking for risky function calls like exec, eval, subprocess.Popen.
Dependency installation – picks the right method (pip, npm, bundler, …) or auto‑detects missing imports.
Execution – finds the entry point (main.py, app.py, or lets you choose) and runs it.
Continue or switch language – after execution you can run another URL, quit, or change the interface language.
🌐 Multilingual Support
The entire interface (menus, warnings, prompts) is available in Arabic and English.
You can choose your language at startup and switch at any time by answering l (change language) after a project finishes.
⚠️ IMPORTANT – Security & Legal Notice
This tool downloads and executes code from the internet.
Only run projects you fully trust. Running untrusted code can compromise your system, steal data, or install malware.
The built‑in security scanner is not foolproof – it cannot detect all malicious patterns.
You are solely responsible for any damage caused by the code you choose to run.
This project is provided for educational and research purposes only. Do not use it to bypass security restrictions or to run harmful software.
🛡️ Disclaimer
text
This tool is not affiliated with GitHub, Python Software Foundation, or any other
mentioned third‑party project. All trademarks belong to their respective owners.
🤝 Contributing
Found a bug? Have a cool feature idea?
Open an Issue for discussion.
Submit a Pull Request with improvements – especially for supporting more languages or better security analysis.
📞 Connect With Me
Platform Handle
GitHub Ali-Haidar-Sy
Telegram @P33_9
Instagram @_ungn
<p align="center"> <strong>⚙️ Automate responsibly. If this tool saves you time, please ⭐ star the repository!</strong> </p> ```