macos_folder_mode.md

macOS Build for AnyLabeling

Overview

The macOS build of AnyLabeling is provided as a directory structure rather than a bundled .app file. This approach offers:

• Easier integration with other tools or scripts
• Customization of the application's resources
• Better compatibility across different macOS versions
• Direct access to application files

Installation

1. Download the appropriate AnyLabeling-Folder.zip (CPU) or AnyLabeling-Folder-GPU.zip (GPU) from the releases page.

2. Extract the downloaded ZIP file:

   unzip AnyLabeling-Folder.zip

3. The extracted folder AnyLabeling-Folder contains everything needed to run the application.

Running the Application

To run the application, execute the anylabeling binary in the folder:

cd AnyLabeling-Folder
./anylabeling

You can also create a shortcut or alias to this executable for easier access.

Building Locally

If you want to build the application yourself:

1. Clone the repository:

   git clone https://github.com/vietanhdev/anylabeling.git
   cd anylabeling

2. Install dependencies:

   pip install -r requirements-macos-dev.txt

3. Make the build script executable:

   chmod +x scripts/build_macos_folder.sh

4. Run the build script:

   # For CPU version
   ./scripts/build_macos_folder.sh
   
   # For GPU version
   ./scripts/build_macos_folder.sh GPU

5. The built application folder will be available at ./dist/AnyLabeling-Folder/ (CPU) or ./dist/AnyLabeling-Folder-GPU/ (GPU).

Troubleshooting

If you encounter issues with the application:

• Ensure you have the correct permissions to execute the application:

  chmod +x AnyLabeling-Folder/anylabeling

• If you get dynamic library loading errors, make sure all dependencies are properly installed:

  pip install -r requirements-macos.txt

• If you encounter graphics or UI issues, try using the CPU version instead of GPU.

• For further assistance, please open an issue on GitHub.