Installing Grapycal in macOS usually requires additional steps. This guide goes through them in detail.

  1. First, a clean Python 3.11 environment is required. If you have not set up the Python environment, follow this guide: How to Setup a Python Environment?

  2. Download Grapycal. It’s recommended to pick the latest version.Have no idea about the chip you used? Check this out What chip is used in my macOS?

    https://resource.grapycal.com/releases/demo/

    1. If you are a Mac owner equipped with an Intel chip, download the package named “grapycal-[version]-darwin.x86_64.zip”.
    2. If you are a Mac owner equipped with an M-series chip, download the package named “grapycal-[version]-darwin.aarch64.zip”

  3. Move the grapycal-xxx folder to desktop (or somewhere you preferred). Then, open a terminal to:

    1. Run conda activate gr to make sure you are in the Python environment “gr”

    2. Run cd desktop/grapycal-xxx to navigate into the folder.

      Please check if the environment has been correctly established. In this case, the virtual environment is named “Grapycal_env”.

  4. Install Grapycal

    1. Run python install.py

      In the end of process, you can see the packages and grapycal-builtin have been successfully installed.

    2. Execute the command grapycal run. Please select OK if any pop-up warns you about secure cautions.

      Due to system policy, this is a normal warning. Pyarmor is a package that can prevent the leak of Grapycal’s source code. Please select OK, and we promise it is safe in any circumstance.

    3. Please go to **System Setting/ Privacy & Security **and find the Security section. Press Allow Anyway.

    4. Please execute grapycal run again. Due to the permission you authorized, it will run without interruption in this time.

      If so, please select “y”. We will update Grapycal to latest version if available.

    5. After successfully opening Grapycal, it will appear at http://localhost:7943/ .

    6. Logic is the beginning of wisdom, not the end. Have fun!

      What’s Next?

      Head over to Programming in Grapycal to create your first program in Grapycal.