⬇️Install the Agent

Agent is needed to run your TaskBots on your computer.

Step 1: Download

Download the agent for Mac, Windows or Linux from https://creator.zerowork.io/download-agent.

Step 2: Install

On Mac

Move the agent icon to the Applications folder.

On Windows

Click on the downloaded .exe file to initiate installation process. If prompted for permissions, confirm and grant access.

On Linux

Select the type you need for your Linux distribution: .AppImage, .deb or .rpm. For Ubuntu or Mint, choose .deb. For Fedora, choose .rpm. Use .AppImage if your distribution doesn’t support .deb or .rpm.

Notes about Linux installation:

  • If you choose to use the .AppImage format, it is recommended to install the AppImageLauncher application (https://github.com/TheAssassin/AppImageLauncher) and use it to add/remove the agent.

  • If after starting the agent and waiting for at least 30 seconds, there is no agent tray icon visible in your toolbar / taskbar, please first make sure the agent is running by opening http://localhost:9990 in your browser. If you see the agent-is-running message as a response, then the issue is likely that the tray icon is missing due to not having the appindicator extension installed. Fix it by installing the "extension manager" app, start it and search for extension named "appindicator ..." and install it. For more details, see: https://linuxiac.com/how-to-enable-system-tray-icons-in-gnome/.

  • The openSUSE distribution is not supported.

Step 3: Double-Click to Activate the Agent

Once installed, double-click the agent to activate it. Double-clicking the agent will make it appear in your toolbar, as shown below (top-right on Mac and bottom-right on Windows).

If you see a security prompt by your operating system, such as "ZeroWork Agent is an app downloaded from the internet. Are you sure you want to open it?", click confirm.

You won’t see any user interface when the agent runs — this is intentional. The agent works quietly in the background, and that's exactly how it’s meant to function. To build and start TaskBots, go to https://creator.zerowork.io.

Mac view

Windows view

Step 4: Confirm Successful Installation

Build a simple TaskBot that opens a link, as described here Open Link. (You can open any link. For example, just use a wikipedia page https://www.wikipedia.org/.) This is meant as a test to confirm that the agent is working.

If you see a browser window popping up, opening that link and then quickly closing the browser window again, then your installation was successful! 🥳

How to Use Agent Options

You can click on the agent in your toolbar to see its options.

In the options, you can see the version of your agent and its status (should be 'ready').

Mac view

Windows view

Video Tutorial: Install ZeroWork Agent

Last updated

Was this helpful?