Instalar bibliotecas Python externas
Instalar bibliotecas Python externas
O Roberty inclui um Python próprio (versão 3.12) que é usado pela ação Código Python. Para usar bibliotecas que não estão instaladas por padrão (como pandas, openpyxl, requests ou qualquer outra), é necessário instalá-las no Python do Roberty via pip.
Até 19 de novembro de 2026, o Roberty usava o Python 3.7, na pasta vendor\python\3.8.1. Bibliotecas instaladas nessa pasta não passam para o Python 3.12: reinstale-as seguindo o Passo 2. Para listar o que estava instalado na versão antiga:
"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip list
Como funciona
O Roberty não usa o Python do sistema — ele tem seu próprio interpretador, localizado em:
C:\Users\{Usuário}\AppData\Roaming\roberty-v4\vendor\python\3.12.10\python.exe
Para que uma biblioteca fique disponível na ação Código Python, ela deve ser instalada nesse Python específico, não no Python do sistema.
O Python do Roberty já vem com o pip instalado — não é preciso nenhuma configuração antes de instalar bibliotecas.
Passo 1 — Abra o Prompt de Comando
Na máquina do Runner, conectado com o mesmo usuário do Windows que executa o Runner, pressione Win + R, digite cmd e pressione Enter.
Passo 2 — Instale a biblioteca com pip
Use o Python do Roberty para chamar o pip:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip install nome-da-biblioteca
Exemplos:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip install pandas
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip install openpyxl requests
Aguarde o pip baixar e instalar os pacotes. Após a conclusão, a biblioteca estará disponível para uso em qualquer robô que use a ação Código Python nessa máquina.
Separe os nomes por espaço para instalar múltiplos pacotes em um único comando:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip install pandas openpyxl requests beautifulsoup4
Passo 3 — Use a biblioteca no código
Com a biblioteca instalada, importe e use normalmente na ação Código Python:
import pandas as pd
import json
# Recebe dados do fluxo como JSON
dados = json.loads('${JSON.stringify(actions["consultarPlanilha"]["value"])}')
df = pd.DataFrame(dados)
resumo = df.groupby("categoria")["valor"].sum().to_dict()
print(json.dumps(resumo))
A instalação é permanente — os pacotes ficam disponíveis para todos os robôs executados nessa máquina enquanto o Runner estiver instalado.
Verificar bibliotecas instaladas
Para listar todas as bibliotecas instaladas no Python do Roberty:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip list
Para verificar se uma biblioteca específica está instalada:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip show pandas
Solução de problemas
O caminho vendor\python\3.12.10 não existe.
O Runner ainda não baixou o Python novo. Reinicie o Roberty Runner, aguarde até que ele fique online e tente novamente.
ModuleNotFoundError ao executar o robô, mesmo após instalar.
Confirme que o pip foi executado com o Python do Roberty (caminho completo com %APPDATA%\roberty-v4\vendor\python\3.12.10\...), e não com o Python do sistema (python -m pip install) nem com o Python antigo (3.8.1). Confirme também que o Prompt de Comando foi aberto com o mesmo usuário do Windows que executa o Runner — cada usuário tem a sua própria pasta %APPDATA%.
A biblioteca não é compatível com Python 3.12. Versões antigas de muitas bibliotecas não existem para o Python 3.12. Instale sem fixar a versão (o pip escolhe a mais recente compatível) ou consulte no PyPI a partir de qual versão o pacote suporta o 3.12:
"%APPDATA%\roberty-v4\vendor\python\3.12.10\python.exe" -m pip install "nome-da-biblioteca>=versao-compativel"
Próximos passos
- Código Python — referência completa da ação
- Instalar bibliotecas Node.js externas — o equivalente para a ação de código JavaScript