/automagica

Open Source (Smart) Robotic Process Automation

Primary LanguagePythonOtherNOASSERTION

Automagica Client

Automagica is an open source Smart Robotic Process Automation (SRPA) platform. With Automagica, automating cross-platform processes becomes a breeze. With this open source library we want to provide a comprehensive and consistent wrapper around known and lesser known automation libraries.

Refer to our website for more information: https://portal.automagica.be

Getting started

Prerequisites

  1. Python 3.6.4 from https://www.python.org
  2. Automagica Bot ID - get one from https://portal.automagica.be

Installation instructions

Install Automagica on the bot host machine:

pip install https://github.com/OakwoodAI/automagica/tarball/master

Optional (to enable Optical Character Recognition)

For Windows, install Tesseract 4 from here.

For Linux (Ubuntu):

sudo apt-get install tesseract-ocr

For MacOS:

brw install tesseract

Running the Bot

  1. Get your Automagica Bot ID from https://portal.automagica.be
  2. In command line or terminal run following command. Replace <bot_id> with your Bot ID.
automagica <bot_id>

If you do not provide a Bot ID, the application will ask for it.

Failsafe

As a safety feature, a failsafe mechanism is enabled by default. You can trigger this by moving your mouse to the upper left corner of the screen. You can disable this by running the following command in the editor:

Failsafe(False)

Examples

Browser working with Excel:

SAP Automation (Real life example, sensitive information is blurred):

Example code

This is a simple example that opens Notepad and types 'Hello world!'.

PressHotkey('win','r')
Wait(seconds=1)
Type(text='notepad', interval_seconds=0)
PressHotkey('enter')
Wait(seconds=2)
Type(text='Hello world!', interval_seconds=0.15)

This is a simple example that opens Chrome and goes to Google.com.

browser = ChromeBrowser()
browser.get('https://google.com')

For more and more extensive examples see the folder 'examples'.

Important notes

For the Type-function to work, you need to set the "United States-International" keyboard layout on your system. If the keyboard layout is not available, outcomes of the function might be different.

Credits

Under the hood, Automagica is built on some of the greatest open source libraries. Within Automagica, the following libraries are currently included:

A special thanks goes out to all the above-mentioned repository contributers! ❤️