Repository files navigation

The repository contains the essential parts of the Robocorp Automation Stack for Python:

• AI Actions, Data Actions and Action Server can be found in Sema4 Ai PyPI packages:
  • sema4ai-actions
  • sema4ai-data
  • sema4ai-action-server
• Python Libraries with which theAutomation Tasks are created are housed and developed under this repository.

The framework includes Python libraries for configuring package's entry points and controlling features such as logging.
The project also provides an extensive selection of libraries for the most common automation tasks, and anything else can be easily done through what is already available in the Python ecosystem.

You can find the source code and library API documentation in this repository.
We strongly recommend to surf our documentationwebsite.

The easiest way to get started is to install therobocorp meta-package, which includes the framework's core features such as definingTasks, logging,Work Items,Vault,Assets and other Control Room integrations.

It's possible to install individual components of the project as separate dependencies.

Name	Release in PyPI	Description	Metapackage
sema4ai-actions		Enables creation of AI Actions for Action Server: "Give hands to your AI"	-
robocorp.tasks		Create entrypoints for your automation project.	✅
robocorp.log		Configure and control the execution log.	✅
robocorp.workitems		Interact with Control Room work items; Read data from previous steps, create output data.	✅
robocorp.vault		Store secret values in Control Room and access them during the execution.	✅
robocorp.storage		Store assets in Control Room and manage them during the execution.	✅
robocorp.browser		Automate actions in a browser, powered byPlaywright.	-
robocorp.windows		Automate Windows desktop applications, powered byuiautomation.	-
robocorp.excel		Read and write Excel files directly, with support for both .xlsx and .xls.	-

⚠️ Any library that isn't included by default inrobocorp (not having the "Metapackage" mark) should be added as a dependency if you wish to make it available in your Python environment.
Do this by listing any of the above as a requirement in your dependencies configuration file:

• conda.yaml for automationTask Packages
• package.yaml for automation Action Packages
• requirements.txt,pyproject.toml,setup.py|cfg etc. for the rest

We followSemVer to the best of our ability in library versioning.
This means that libraries with version0.x.x are in the development phase, so there can be breaking changes on anyversion update.
We aim to get libraries to version1 as soon as possible, and after that, following the expected SemVer rules.

A new major version will be published when breaking changes are introduced, therefore the changelog should contain guidance on migration given what was changed.

Be aware that modules starting with an underscore_ are not considered part of the public API and should not be imported directly!
So only the functions/classes reached from therobocorp.<library> namespace should be used. If availability to some other private object is needed, please create a feature request to address it.

• RPA Framework for Python

  • For additional automation capabilities on the Robocorp platform, please refer to the wide array of libraries and keywords available inrpaframework.
  • PyPI
  • GitHub
  • Documentation

• 3rd-party libraries

  • We are also collecting pointers to other 3rd-party libraries that we see as commonly used or just beneficial to automation cases.
  • We try to collect the needed links and provide some common code snippets to help you on your way.
  • Documentation