mirror of
https://github.com/blw1138/cross-py-builder.git
synced 2025-12-17 08:38:11 +00:00
78 lines
2.0 KiB
Markdown
78 lines
2.0 KiB
Markdown
# Cross-Py-Builder
|
|
|
|
Cross-Py-Builder is a simple remote build tool for compiling Python projects with PyInstaller on different platforms on a local network.
|
|
|
|
## System Requirements
|
|
- **Ubuntu/Debian & macOS:** 2GB+ RAM
|
|
- **Windows:** 4GB+ RAM
|
|
- **Python 3.10 or later** installed
|
|
- **Local Network** for build agents
|
|
|
|
---
|
|
|
|
### Example Usage
|
|
|
|
|
|
```sh
|
|
./cross-py-builder.py --build /path/to/repo -cpu x64 -os windows
|
|
|
|
options:
|
|
-h, --help show this help message and exit
|
|
--status Get status of available servers
|
|
--build BUILD Path to the project to build
|
|
-cpu CPU CPU architecture
|
|
-os OS Operating system
|
|
-d, --download Download after build
|
|
--delete-cache Delete cache
|
|
--update-all Update build agent
|
|
--restart RESTART Hostname to restart
|
|
--restart-all Restart all agents
|
|
--shutdown SHUTDOWN Hostname to shutdown
|
|
--shutdown-all Shutdown all agents
|
|
```
|
|
|
|
---
|
|
|
|
## Worker VM Setup Guide
|
|
|
|
This guide provides steps to set up a worker VM on **Ubuntu/Debian, macOS, or Windows**.
|
|
|
|
|
|
### Ubuntu/Debian or macOS
|
|
1. **Create a new VM** and install the OS.
|
|
2. **Update the system:**
|
|
- **Ubuntu/Debian:**
|
|
```sh
|
|
sudo apt update && sudo apt upgrade -y
|
|
sudo apt install python3-pip python3-venv -y
|
|
```
|
|
- **macOS:**
|
|
```sh
|
|
xcode-select --install # Install xcode tools
|
|
```
|
|
3. **Install Python** >=3.10 from [python.org](https://www.python.org/downloads/) (Windows and macOS - macOS)
|
|
4. **Set up a virtual environment:**
|
|
- **Ubuntu/Debian/macOS:**
|
|
```sh
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
```
|
|
- **Windows:**
|
|
```sh
|
|
python3 -m venv venv
|
|
venv\Scripts\activate
|
|
```
|
|
5. **Copy project files** and install dependencies:
|
|
```sh
|
|
pip install -r requirements.txt
|
|
```
|
|
6. **Start Build Agent**:
|
|
- **Ubuntu/Debian/macOS:**
|
|
```sh
|
|
python3 build_agent.py
|
|
```
|
|
- **Windows:**
|
|
```sh
|
|
python build_agent.py
|
|
```
|
|
--- |