Skip to content

Latest commit

 

History

History
88 lines (53 loc) · 4.09 KB

install-from-git.md

File metadata and controls

88 lines (53 loc) · 4.09 KB

Installation (git)

Note Minimum version of Python is 3.10. If having trouble running ankerctl.py try running it via python3.10 ankerctly.py or your installed equivalent

Windows

  1. Install the AnkerMake slicer. Make sure you open it and login via the “Account” dropdown in the top toolbar. NOTE: The slicer app does not need to be open for the rest of these steps.

  2. Using git or GitHub Desktop, clone this repository into a location of your choice and then navigate to that location in File Explorer.

  3. Hold down the "Shift" key and right-click on some empty space in the repository top level folder. Select "Open in Terminal" (Windows 11) or "Open PowerShell window here" (Windows 10) from the context menu dropdown. (If the following commands do not work, try re-opening your terminal window as administrator and use the cd command to navigate to where you cloned this repository)

  4. Enter in the following command to install/check Python 3:

    python3

    Now, one of two things will happen:

  • The first possibility is that the Microsoft Store will open and prompt you to install Python 3.10 or newer. You can do that and that's a perfectly fine way to install Python 3 or you can go to the Python website and install it from there. Either way works, do whichever you prefer. Then enter in the above command again after and you should see what's in the next bullet.

  • The other possibility is that you get a message similar to this:

    Python 3.10.10 (tags/v3.10.10:aad5f6a, Feb  7 2023, 17:20:36) [MSC v.1929 64 bit (AMD64)] on win32
    Type "help", "copyright", "credits" or "license" for more information.
    >>>
    

    This means you already have Python 3 installed and are good to go on to the next step. Enter in the following command to exit out of the Python 3 runtime environment.

    quit()
  1. Enter in the following command to install the required packages using pip:

    pip3 install -r requirements.txt

    If required, enter Y to all installation prompts.

  2. You now should be able to run ankerctl.py

MacOS

  1. Install the AnkerMake slicer. Make sure you open it and login via the “Account” dropdown in the top toolbar. NOTE: The slicer app does not need to be open for the rest of these steps.

  2. Using git or GitHub Desktop, clone this repository into a location of your choice and then navigate to that location in Finder.

  3. Hold down the "Control" key and click the folder in the path bar, then choose "Open in Terminal". (If you don’t see the path bar at the bottom of the Finder window, choose View > Show Path Bar)

  4. Install Python3 from the Python website., homebrew, or Anaconda. It needs to be 3.10 or newer.

  5. Enter in the following command to install the required pip packages:

    pip3 install -r requirements.txt

    If required, enter Y to all installation prompts.

  6. You now should be able to run ankerctl.py

Linux

  1. Install the AnkerMake slicer. Alternatively, you can install the slicer on a officially supported operating system that you have access to (Windows or MacOS) and use the login.json file from that machine. Either way you choose, make sure you open the slicer and login via the “Account” dropdown in the top toolbar.

    NOTE: The slicer app does not need to be open for the rest of these steps.

  2. Using git, clone this repository into a location of your choice and then navigate to that location in your terminal app of choice.

  3. Install Python3 from whatever package manager your distro uses via the terminal. The minimum version has to be 3.10 or newer.

  4. Enter in the following command to install the required pip packages:

    pip3 install -r requirements.txt

    If required, enter Y to all installation prompts.

  5. You now should be able to run ankerctl.py