Install and Setup


TestWise is available for Windows and macOS platforms.

Install TestWise on Windows

TestWise for Windows comes in the following three editions:

  • Standard edition

    Installing TestWise is quick and easy. Just run the installer and accept all the default options. The default installation dir is C:\agileway\TestWise6.

  • Ruby Edition - recommended

    This is the standard edition with Ruby 2.6 bundled. This is suitable for users who uses Ruby as the scripting language, which will same the efforts on Ruby installation.

    If you have no preferences in terms of scripting language, we would recommend Ruby. This version is easier to start.

  • Portable edition

    There is no installer, just unzip it to a folder and run testwise.texe in it. This is suitable for users who have limited privileges on their computers.

Functionally, they are exactly the same. Choose one that is most convenient to you.

Except for Ruby edition, TestWise does not include execution runtime for test scripts, for which you can easily configure. See the section below.

Install on macOS

Download and open the TestWise-XX.dmg file, then drag the to Applications.


Launch TestWise

Double click “TestWise.exe” to start TestWise ( or ‘’ icon on macOS). If you start TestWise the first time or unregistered, a dialog will be shown. You just need to wait (or look at the test automation tips) for 10 seconds, and click ‘Continue’ button to start to use TestWise.


Please note, unlike YouTube, this is not advertisement. Many will find these tips (mostly excerpt from the classic Agile books) useful. Unregistered TestWise has full features (the same as registered one), except: 10-second wait on start and execution token limits, the convenience that the registered TestWise customers are willing to pay (US$25/month).

When you run out of execution tokens, just restart TestWise (which will get you 15 execution tokens instantly and may request 10 every hour from site). You may keep using TestWise free-of-charge this way.

Set up Execution Path

By default, TestWise does not include the execution languages and their testing libraries. Instead it provides users the freedom to configure it. For example, if your choice of test framework is Mocha, you just add the PATH of node and mocha to TestWise’s execution setting. Then TestWise will use them to execute Mocha tests.

The only exception is Ruby. Because I like Ruby so much, I bundled a TestWise Ruby edition (Windows only) which packs Ruby under interpreters folder. Of course, you may use a specific Ruby release by setting the execution PATH as shown below.


For first-time installation, TestWise will try to use existing PATH. In this case, please verify and update accordingly.

  • Ruby, e.g. C:\Ruby26-x64\bin If you using Ruby edition, you may ignore this.

  • Python, e.g. C:\agileway\Python374\Scripts;C:\agileway\Python374

  • Node.js, e.g. C:\Program Files\nodejs;C:\Users\CIO\AppData\Roaming\npm

  • Git, e.g. C:\Program Files\Git\cmd

  • Browser driver PATH, such as chromedriver and geckodriver (for Firefox)

To verify, Click ‘Check’ button to go to “Frameworks” tab, and click “Detect” button.


The version number, if existing in configured PATH, will be shown next to the framework.