Skip to content

Frequently Asked Questions

How to solve the problem of installation stuck at 0%?

This type of problem is more common in cases where there are blockages in the company's environment where the tools are being used. Here are some of the behaviors observed:

  • Installation through the Wizard is stuck at 0%.
  • Failed to log in to BotCity Studio.
  • Authentication error when starting BotCity Runner.

The ideal solution in this case would be to ask the company's IT team for some access permissions. See more details about the URLs that require access in the section: Problems with blocking environments.

How to resolve dependency installation issues when running automation (ModuleNotFoundError)?

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 ensure the same Python interpreter is used to install the dependencies and run the code. Something common is that the IDE creates a virtual environment for the project; if this virtual environment is used to install the dependencies but when running the system's "global" Python is being used, then this error will probably be thrown.

After ensuring the environment configuration is correct, use the same Python interpreter to install the dependencies: pip install --upgrade -r requirements.txt and run the code later.


If you are having a similar problem with another dependency when running your automation using BotCity Runner, check whether the dependency was correctly defined in the robot's requirements.txt file.

What are the features and limitations of a Community license on Maestro?

A new account that is created on Maestro has full access to the platform's functionalities (trial) for a period of 30 days. After this period of 30 days, access to the platform continues in the same way; the only difference is some limitations and access to some specific resources.

After the trial period, it is no longer possible to use the following features:

  • Credentials
  • Audit
  • Schedules
  • BotCity Documents

Additionally, the workspace will also have some limitations on other features:

  • Tasks - maximum of 10 tasks created per day
  • Automations - maximum of 1 automation process on the platform
  • Runners - maximum of 1 Desktop Runner on the platform

See more details about the difference between the plans and available resources by accessing this link.


The limitations of a Community license are focused on the orchestration step in Maestro.

The automation development stage does not have any limitations regarding the use of BotCity frameworks and plugins.

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:

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, what can cause this type of problem is the resources used by the previous execution, which have not been correctly finalized. Thus, when there is an attempt in the code to reaccess these resources, a conflict occurs because the operating system considers these resources already "in use".

A classic example is the use of web drivers in web automation. Without proper finishing, the web driver may continue to run even after the process is completed, causing this to affect the following executions.

A possible solution to this type of problem is to include treatments in the code to ensure that all resources allocated and used by the robot are finished correctly at the end of execution, even in cases where exceptions occur.

Following this good practice, every time the Runner performs this process, the environment will be "clean"; therefore, there will be no problems using specific resources.


You can also always consult the log.txt file generated by the Runner to verify any exceptions during the environment preparation and process execution.