FAQ
Why is the Runner stuck on "Executing task..." and how to fix it?
Overview Occasionally, the BotCity Runner may appear stuck after retrieving a new task from the queue. In these cases, the status remains as: Executing task... and the automation does not actually start until the Runner is manually restarted. Likely ...
How to Resolve the “ModuleNotFoundError” When Running Your Automation?
Overview If you encounter the following error when running your automation: ModuleNotFoundError: No module named 'botcity' this means the Python environment being used to run the automation cannot find the required package. This issue is typically ...
How to Resolve the Issue of Installation Stuck at 0% in BotCity Studio ?
Overview If you're trying to install BotCity Studio or start the BotCity Runner and the installation gets stuck at 0%, or you experience authentication or login errors, it is very likely that your corporate environment is blocking the required ...
Best Practices for Using BotCity Windows Inspector
Introduction When developing automations with the BotCity Windows Inspector, following certain best practices can significantly improve your experience and results. Below are key recommendations and important points to consider during development. ...
How to Diagnose and Fix Installation, Authentication, or Execution Issues with BotCity Tools
Diagnosis To assist in identifying these issues, starting from version 1.2.5, the Wizard now includes the Diagnostic tool, which aims to check: Connectivity with BotCity services Possible network blocks Installed versions of Python and Java in the ...
"Session Not Found" Error When Using a Startup Script to Disconnect User Sessions
Issue Description When using a startup or logout script to disconnect user sessions on Windows, some users encounter the following error: Session not found This usually happens when the username contains spaces, for example: USER NAME In such cases, ...
Issues Finding Elements with Computer Vision (find Method)
Description In some cases, users report difficulty locating screen elements using the find method, which is based on computer vision (CV). This issue can arise due to various factors, such as screen resolution, system theme, visual obstructions, or ...
Where Can I Find Learning Resources and Courses to Get Started with BotCity ?
Description It’s common for new users creating an account on BotCity to express interest in learning more about the platform. These questions often come through the Maestro support chat, either during the sign-up process or shortly after account ...
What Features Are Available on a Free BotCity Maestro Account ?
Description A common question from new users of BotCity Maestro is what features are included in a free (community) account. These questions often come through the support chat on the sign-up screen, and usually include: How many bots can I create? ...
How to fix Python environment preparation failed error
A very common error when executing automations through the Runner is Python Environment Preparation Failed. As the name suggests, the Runner fails when trying to prepare the Python environment for the robot's execution. This error occurs in different ...
Error Running Wizard.exe: How to Fix It?
Issue When attempting to start the installation, configuration, or authentication process of the BotCity Runner using the wizard in .exe format, you may encounter difficulties opening the file. This error usually occurs due to company security ...
Error Running Edge Browser via Orchestrator: How to Fix It?
Issue During the execution of robots using the Microsoft Edge browser through the orchestrator, a specific issue was identified: the browser did not start correctly, whereas when running locally, the flow executed normally. The error presented was: ...
Datapool Inaccessible After Repository Migration: How to Fix ?
Issue During the migration of robots to new repositories, a failure was identified: some old repositories that still contained logs and datapools had been deleted or lost access. As a result, important information (execution logs and data pools) ...
Resolving SSL certificate verification issues when running commands using 'pip'
Access blocks are quite common in corporate environments. As a result, you may encounter problems when trying to use BotCity tools and Python resources on a machine in your company's environment. One problem that may occur in these scenarios is the ...
Troubleshooting when using ‘Print Screen’ in BotCity Studio
In some sporadic cases, when using the 'Print Screen' key to take a screenshot, the captured image is not displayed in Studio. This behavior may be related to several factors, such as other applications intercepting the 'Print Screen' action, ...
Keeping your remote session active when using Runner
In some cases where a VM is used to run the automation, keeping the remote session active is necessary to avoid problems with the graphical interface, such as the OSError: screen grab failed error. This error is usually thrown when trying to perform ...
What to do when Runner seems stuck when executing a new task?
In sporadic situations, the Runner may seem stuck after pulling a new task for execution. In this situation, the execution is not started, and the Runner status remains as Executing task ... until the Runner is restarted. Overall, the resources used ...
Where can I find content to learn more about using BotCity?
A great alternative to have a first contact with the tools is to access the courses available on BotCity Academy. Additionally, you can also access the tutorials available on the documentation portal: Getting started with BotCity Developing your ...
What are the features and limitations of a Community license on BotCity Orchestrator?
A new account that is created on BotCity Orchestrator has full access to the platform's functionalities (trial) for a period of 30 days. After this 30-day period, access to the platform continues in the same way; the only differences are some ...
Problems with dependencies when running an automation
This problem usually occurs when the dependencies installation step is not done correctly. When running the code, a message is displayed regarding the installation of the packages: ModuleNotFoundError: No module named 'botcity’ The first step is to ...
Problems with blocking environments
If you are trying to use BotCity's tools in a corporate environment, you may encounter some issues related to environment locks. Here are some of the most common issues when using the BotCity Studio SDK in blocking environments: Installation through ...