⬇️Install the Agent
Agent is needed to run your TaskBots on your computer.
Agent does not have any user interface, it simply 'sits' on your desktop to run TaskBots. The actual building of TaskBots is done at https://creator.zerowork.io/workflows.
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! 🥳
On Windows, the browser window where the TaskBot runs might not get in front. It might stay behind your primary window. Simply toggle Stay on Page after Run or minimize your windows after the TaskBot finishes running to locate the Chrome window.
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?