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:
- Python Libraries with which the Automation 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 documentation website.
The easiest way to get started is to install the robocorp meta-package, which includes the framework's core features such as defining Tasks, 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 by Playwright. | - |
robocorp.windows |
 |
Automate Windows desktop applications, powered by uiautomation. | - |
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 automation Task Packages
- package.yaml for automation Action Packages
- requirements.txt, pyproject.toml, setup.py|cfg etc. for the rest
We follow SemVer to the best of our ability in library versioning.
This means that libraries with version 0.x.x are in the development phase, so there can be breaking changes on any
version update.
We aim to get libraries to version 1 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.
-
- For additional automation capabilities on the Robocorp platform, please refer to the wide array of libraries and keywords available in rpaframework.
- PyPI
- GitHub
- Documentation
-
- 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