Skip to content

Download and install

Retool is supported on Windows 10+, Ubuntu 20+, and macOS 10+.

How you download and install Retool will depend on your level of comfort with code, and the operating system you use.

If you're a Windows user and want the easiest path, you can get Retool going in a few easy steps:

  1. Download the Windows binary ZIP file:

    retool-2.4.6-win-x86-64.zip

    SHA256: dddef1ac0bd8afee060d45bd9b956d787ef83281ee6004ab9393f1b1ed763f1c

  2. Extract the ZIP file to a folder of your choosing.

  3. In that folder, double click retoolgui.exe. A Command Prompt window opens, which shows the output when Retool is running. Don't close it, as this also closes the GUI.

  4. Click File > Update clone lists to download the latest clone lists and metadata files.

    SSL: CERTIFICATE_VERIFY_FAILED error

    If you see the error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate when trying to download files in Retool, see Troubleshooting for the fix.

Note

Retool's binary is UPX packed to reduce its size on disk. This means that some over-zealous anti-virus software might pick it up as a false positive. If the SHA256 of the downloaded ZIP matches the checksum on this page, you're likely safe to mark an exception in your anti-virus software.

If you're more comfortable with the command line, or are running on a non-Windows platform, then this option is for you.

  1. Download and install Python 3.10 or higher, if you haven't already.

  2. Clone Retool from its repository:

    git clone https://github.com/unexpectedpanda/retool.git

  3. Install Retool's dependencies, either with Pip or Hatch:

    python3 -m pip install alive-progress lxml psutil pyside6 darkdetect strictyaml validators

    1. Install Hatch if you haven't already:

      python3 -m pip install hatch

    2. Enter the Hatch virtual environment:

      hatch shell

      To exit the environment at any time, run the exit command.

  4. Download the latest clone lists and metadata files:

    python3 retool.py --update

    SSL: CERTIFICATE_VERIFY_FAILED error

    If you see the error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate on macOS when trying to download files in Retool, see Troubleshooting for the fix.

  5. You can now run retool.py or retoolgui.py.