Installing OSCAR 1.7.1 on MacOS

🛠️ Already have OSCAR? Upgrade to the latest version here.

Follow the steps below to install OSCAR v1.7.1. Basic familiarity with using a terminal is assumed.

Having trouble? Visit our Contact & Support page for help.

Step 1: Install prerequisites

If you are using macOS 10.12 or newer, you need to install the Xcode command line tools, as explained in the following instructions.

1. Launch a Terminal and copy and paste the command xcode-select --install, then press enter.
2. A window will appear asking you: The xcode-select command requires the command line developer tools. Would you like to install the tools now?. Confirm this by clicking Install.
3. Wait for this to complete; it needs to download about 130 MB of data.
4. You can verify that everything worked by verifying that the folder /Library/Developer/CommandLineTools/usr/bin/ exists and contains executables such as clang and clang++, the C and C++ compiler.

Step 2: Install Julia

OSCAR requires Julia 1.10 or higher. We recommend installing the latest stable release of Julia by entering the following in a terminal and heeding the instructions it shows:

curl -fsSL https://install.julialang.org | sh

Step 3: Install OSCAR

1. Open the Julia REPL in your terminal by typing the following:

   julia
   

2. Install OSCAR by running the following commands. This may take a while, as OSCAR and its dependencies will be downloaded and installed.

   using Pkg
   Pkg.add("Oscar")
   

Step 4: Start OSCAR

Run using Oscar in the Julia REPL:

julia> using Oscar
  ___   ___   ___    _    ____
 / _ \ / __\ / __\  / \  |  _ \  | Combining and extending ANTIC, GAP,
| |_| |\__ \| |__  / ^ \ |  ´ /  | Polymake and Singular
 \___/ \___/ \___//_/ \_\|_|\_\  | Type "?Oscar" for more information
o--------o-----o-----o--------o  | Documentation: https://docs.oscar-system.org
  S Y M B O L I C   T O O L S    | Version 1.7.1

Optional: Running Tutorials Locally with IJulia

If you would like to run the OSCAR tutorials locally, you can do so using IJulia.

1. Install IJulia (and Jupyter) by running the following command inside your Julia REPL:

   using Pkg; Pkg.add("IJulia")
   

   For more details, see the IJulia installation guide. If you encounter issues, you may need to explicitly build IJulia. Troubleshooting information is available on the IJulia troubleshooting page.

2. Download one of the OSCAR tutorials.
3. Start Jupyter by running the following in your Julia REPL:

   using IJulia; notebook()
   

4. Your web browser should open the Jupyter interface. In the upper-left corner you should see “Jupyter”; the file explorer appears below it. Locate and open the tutorial notebook you downloaded. If you see a message such as Kernel not found or Kernel error, select a different Julia kernel in the top-right corner of the notebook.