ZeroWork
  • 👋Home and Welcome
  • 🚀Getting Started
  • ⬇️Install the Agent
  • 🧑‍💻Crash Course
  • Using ZeroWork
    • 🖥️General: Run, Schedule, Share, Webhooks
      • Run
      • Stop
      • Log in to the Agent
      • Run Modes
        • Run Incognito
        • Run Non-Incognito
        • Run in My Regular Browser
      • Run Settings
        • Run in Background
        • Stay on Page after Run
        • Bring Pages to Front
      • TaskBot Sharing Options
      • Cookies
      • Scheduler
      • Trigger Run via Webhook
      • Proxies
      • Remote (Cloud) Execution
      • How to Check and Update Your Agent
      • Install ZeroWork Agent on VPS
    • 📔Using Selectors
      • What Are Selectors
      • Use Element's Text
      • Copy Selectors
      • How to Build Custom Selectors
        • Basic Concepts of Selectors
        • One Element Can Have Many Selector Expressions
        • Check if Selector Is Correct and Unique
        • Exact or Loose Match
        • Hierarchy
        • Combine Filters with Standard CSS Logic
        • Lists: Incremental CSS Selectors
        • Addressing Siblings
      • How to Use XPath in ZeroWork (advanced)
    • 🏗️Using Building Blocks
      • Open Link
      • Save Page Url
      • Switch or Close Tab
      • Go Back or Forward
      • Switch Frame
      • Browser Alert
      • Click Web Element
      • Check Web Element
      • Save Web Element
        • Save Lists
        • Enrich Existing Data
        • Stop Run If Selector Is Not Found Option
      • Insert Text or Data
      • Hover Web Element
      • Select Web Dropdown
      • Keyboard Action
      • Start Condition and Set Condition
        • Actions = & ≠
        • Actions <, ≤, >, ≥
        • Data Found & Data not Found
        • Contains & Does Not Contain
        • Before (Date) & After (Date)
      • Start Repeat
        • Standard Loop
        • Dynamic Loop
        • Continue until No Element Is Found
        • Auto-Scroll
        • Auto-Continue from Last Row or Element
        • Nested Loops - Handle Pagination
      • After Repeat
      • Break Repeat
      • Try-Catch
      • Raise Error
      • Abort Run
      • Update Data
      • Number Operations
        • Example: Standardize different formats
      • Format Data
        • Remove Words
        • Shorten Content Length
      • Split Data
      • Apply Regex
      • Remove Duplicates
      • Delete Data
      • Ask ChatGPT
      • Send Notification
      • APIs: Send HTTP Request
      • Write JavaScript
      • Save File
      • Upload File
      • Delay
      • Record Date
      • Take Screenshot
      • Save from Clipboard
      • Log
      • Building Block Options
        • Delay Times between the Building Blocks
        • Randomize Delay Time
        • Deactivate Building Blocks
        • Shortcuts
        • Spintax
        • Auto-Align
        • Sticky Notes
    • 🔀Using Variables
    • 💿Using Tables
      • How to Add Tables
      • Native Tables
      • Google Sheets
      • Import Data from CSV
      • Using Google Sheet vs. Native Tables
      • Create Columns
      • Export Data as CSV
      • Convert Native Table to a Google Sheet
    • 📄Using Run Reports
    • 😑Common Problems
      • My TaskBot Does Not Start Run
      • When I Use Data from Table, No Data is Being Pulled
      • Website is Glitching and Flashing
      • No Selector is Found
      • My TaskBot Saves Some Data but Not All
      • Data Is Saved in Wrong Format
      • Website Requires SMS or Email Verification
      • Keyboard Action Is Not Working As Expected
      • Check Web Element Identifies Selector as Found but Next Action Does Not
      • When Using Insert Data Block, First Letters Are Cut Off
      • Workflow Has More than One Starting Building Block
      • TaskBot Does Not Automatically Scroll
  • Support
    • 🆘Getting Support
  • 🆕Release Notes
    • Version 1.1.61
    • Version 1.1.62
    • Version 1.1.63
    • Version 1.1.64
    • Version 1.1.65
    • Version 1.1.66
    • Version 1.1.67
    • Version 1.1.68
Powered by GitBook
On this page
  • Step 1: Download
  • Step 2: Install
  • Step 3: Double Click to Activate the Agent
  • Step 4: Confirm Successful Installation
  • How to Use Agent Options
  • Video Tutorial: Install ZeroWork Agent

Was this helpful?

Install the Agent

PreviousGetting StartedNextCrash Course

Last updated 22 days ago

Was this helpful?

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 .

Step 1: Download

Go to and download the agent for Mac, Windows or Linux.

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 asked to grant access or confirm that you really want to install the application, grant access and confirm.

On Linux

Select the type you need for your Linux distribution: .AppImage, .deb or .rpm. For example, for Ubuntu or Mint it would be .deb and for Fedora it would be .rpm. Use .AppImage for any Linux distribution that does not accept .deb or .rpm formats.

Notes about Linux installation:

  • The openSUSE distribution is not supported.

Step 3: Double Click to Activate the Agent

Once the agent is installed, double click on it to activate it. Double clicking on the agent will make it appear on your toolbar, as shown below. On Mac, the toolbar is on top right and on Windows it's on bottom right. You will not see any user interface. This is normal and intended. 😊

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 / open.

Mac view

Windows view

Step 4: Confirm Successful Installation

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 and minimize all your windows after the TaskBot finished its run to 'search' for the 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

If you choose to use the .AppImage format, it is recommended to install the AppImageLauncher application () 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 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: .

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 .) This is meant as a test to confirm that the agent is working.

⬇️
https://github.com/TheAssassin/AppImageLauncher
http://localhost:9990
https://linuxiac.com/how-to-enable-system-tray-icons-in-gnome/
https://www.wikipedia.org/
https://creator.zerowork.io/workflows
https://creator.zerowork.io/download-agent