# 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
      ```
---