Skip to main content
Acessar Studio

Instalar bibliotecas Python externas

O Roberty inclui um Python próprio (versão 3.7) 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.

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.8.1\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.

Passo 1 — Abra o Prompt de Comando​

Pressione Win + R, digite cmd e pressione Enter.

Passo 2 — Habilitar o site-packages (primeira vez)​

O Python bundled do Roberty usa a distribuição embarcada do Windows, que desabilita o diretório de pacotes por padrão. Antes de instalar qualquer biblioteca, é necessário habilitar o site-packages editando um arquivo de configuração.

  1. Abra o Explorador de Arquivos e navegue para: 
    %APPDATA%\roberty-v4\vendor\python\3.8.1\
  2. Localize o arquivo python37._pth e abra-o com o Bloco de Notas.
  3. Encontre a linha #import site e remova o #, deixando apenas import site.
  4. Salve o arquivo.

Passo 3 — Instalar o pip (primeira vez)​

Com o site-packages habilitado, baixe e execute o script de instalação do pip:

  1. Baixe o arquivo get-pip.py em: https://bootstrap.pypa.io/pip/3.7/get-pip.py
  2. No Prompt de Comando, execute:
"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" caminho\para\get-pip.py

Após a conclusão, o pip estará instalado permanentemente nesse Python. Os Passos 2 e 3 são feitos uma única vez — não é necessário repetir para instalar outras bibliotecas no futuro.

Passo 4 — Instale a biblioteca com pip​

Use o Python do Roberty para chamar o pip:

"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip install nome-da-biblioteca

Exemplos:

"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip install pandas
"%APPDATA%\roberty-v4\vendor\python\3.8.1\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.

Instalar várias bibliotecas de uma vez

Separe os nomes por espaço para instalar múltiplos pacotes em um único comando:

"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip install pandas openpyxl requests beautifulsoup4

Passo 5 — 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.8.1\python.exe" -m pip list

Para verificar se uma biblioteca específica está instalada:

"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip show pandas

Solução de problemas​

No module named pip ao tentar instalar. O pip ainda não foi instalado. Siga os Passos 2 e 3 deste tutorial para habilitá-lo.

No module named ensurepip ao tentar usar ensurepip. O Python bundled do Roberty é a distribuição embarcada do Windows e não inclui ensurepip. Use o método get-pip.py descrito no Passo 3.

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\...), e não com o Python do sistema (python -m pip install). Verifique também se o arquivo python37._pth foi editado corretamente (Passo 2).

O pip retorna erro de permissão. Execute o Prompt de Comando como Administrador e tente novamente.

A biblioteca não é compatível com Python 3.7. Verifique a compatibilidade da versão no PyPI. Algumas bibliotecas mais recentes exigem Python 3.8 ou superior — nesse caso, procure uma versão mais antiga do pacote que suporte 3.7:

"%APPDATA%\roberty-v4\vendor\python\3.8.1\python.exe" -m pip install "nome-da-biblioteca==versao-compativel"

Próximos passos​