Como resolver o erro “ModuleNotFoundError” ao executar a automação ?

Como resolver o erro “ModuleNotFoundError” ao executar a automação ?

Visão Geral

Se ao rodar sua automação você encontrar o erro:
WarningModuleNotFoundError: No module named 'botcity'

isso indica que o ambiente de execução não está encontrando o pacote necessário. Esse problema geralmente está relacionado à instalação incorreta das dependências do projeto ou ao uso de um interpretador Python diferente daquele em que os pacotes foram instalados.


Causa Comum

Um dos cenários mais frequentes ocorre quando:

  • A IDE (como PyCharm ou VSCode) cria automaticamente um ambiente virtual (venv) para o projeto.

  • As dependências são instaladas nesse ambiente virtual.

  • Na hora de executar o código, o Python utilizado é o global do sistema, e não o ambiente virtual onde os pacotes estão instalados.

Nesse caso, o Python "global" não possui os módulos necessários — como o botcity — e o erro é lançado.


Solução

Etapa 1: Verifique qual interpretador Python está sendo usado

  • Certifique-se de que o Python usado para instalar as dependências é o mesmo Python usado para executar a automação.

  • Se estiver usando um ambiente virtual, ative-o corretamente antes de rodar qualquer comando.

Etapa 2: Instale as dependências corretamente

Dentro do ambiente virtual ou com o interpretador correto selecionado, execute:

pip install --upgrade -r requirements.txt

Esse comando irá instalar (ou atualizar) todas as dependências definidas no seu projeto.

Etapa 3: Execute a automação com o mesmo interpretador

Sempre execute sua automação usando o mesmo ambiente virtual ou interpretador onde as dependências foram instaladas.


Atenção ao usar o BotCity Runner

Se você estiver executando a automação com o BotCity Runner e se deparar com erros semelhantes para outras bibliotecas, verifique:

  • Se o módulo ausente está listado corretamente no arquivo requirements.txt da automação.

  • O Runner usa esse arquivo para instalar os pacotes necessários automaticamente durante a execução da tarefa.


Conclusão

O erro ModuleNotFoundError está diretamente relacionado à forma como as dependências são instaladas e qual interpretador Python é utilizado na execução. Garantir a consistência entre instalação e execução é essencial para o funcionamento correto da automação, em caso de dúvidas pode consultar a documentação oficial da BotCity.