Installation

Installation and Setup

This page describes the different methods to install and run ALIG on your system.

1. Windows (Recommended)

For Windows users, ALIG is distributed as a standalone executable. This version does not require a Python installation on your machine, as all necessary dependencies are bundled within the package.

Steps to install:

1. Navigate to the Releases section of the GitHub repository.
2. Download the latest version: ALIG_vX.XXXX.exe.
3. Move the executable to a dedicated folder (e.g., C:\CNC_Tools\ALIG).
4. Run the .exe file. On the first launch, the application will automatically create an /assets folder in the same directory to store your configurations and thumbnails.

---

2. Other Systems (Building from Source)

If you are running Linux or macOS, or if you prefer to run the software directly via Python, you must build the environment manually.

Prerequisites

• Python 3.10 or higher.
• pip (Python package installer).

Installation Procedure

1. Clone the repository:

   git clone [https://github.com/MoMo830/AliG.git](https://github.com/MoMo830/AliG.git)
   cd AliG
   

2. Create a virtual environment (Recommended): python -m venv venv source venv/bin/activate

3. Install dependencies: pip install -r requirements.txt

4. Run the application: python main.py

Post-Installation Notes: Permissions: Ensure the application has write permissions in its folder to save alig_config.json