Quick Start #03PyAutoGUIPython
/ Automação de interface gráfica

PyAutoGUI.
Automatize o que você vê.

Controle mouse e teclado com Python para automatizar tarefas visuais, preencher sistemas e executar rotinas quando uma API não está disponível.

MouseTecladoGUIRPA
Monitor com ponteiro representando automação com PyAutoGUI
/ Por que usar PyAutoGUI?

Quando a interface é o caminho.

PyAutoGUI simula ações humanas na tela. Ele é útil para aprender automação visual e para integrar etapas de sistemas que não oferecem uma API ou outro meio estruturado de integração.

mouse

Mouse

Mova o ponteiro, clique, dê duplo clique, pressione e arraste por coordenadas da tela.

keyboard

Teclado

Digite textos, pressione teclas e combine atalhos como Ctrl+S, Enter ou Tab.

fact_check

Formulários

Automatize preenchimento de campos, checkboxes e botões em aplicações de desktop.

draw

Arrastar

Use mouseDown e mouseUp para desenhar, selecionar áreas ou arrastar elementos.

screenshot_monitor

Tela como referência

Coordenadas e imagens permitem orientar a automação pelo que aparece na interface.

history

Sistemas legados

Pode ser uma ponte para aplicações antigas que não expõem API, banco ou integração direta.

repeat

Tarefas repetitivas

Transforme sequências de cliques e digitação em um script reproduzível.

school

Visual e didático

É fácil enxergar a automação acontecendo e relacionar cada comando ao resultado na tela.

info

E quando não usar? Se o sistema possui uma API estável, ela normalmente é mais robusta do que automatizar cliques. PyAutoGUI depende da posição e do estado visual da interface; mudanças de resolução, janela ou layout podem exigir ajustes.

01

Instale no seu computador

# Execute uma vez no terminal: pip install pyautogui

Essa instalação é para o ambiente Python do seu computador. No notebook do Colab, a instalação e o desktop virtual já são preparados pela única célula de demonstração.

02

Descubra onde o mouse está

import pyautogui x, y = pyautogui.position() print(x, y)

A tela funciona como um plano de coordenadas. A posição `(x, y)` informa onde o ponteiro está naquele momento.

03

Mova o ponteiro

pyautogui.moveTo(x + 150, y, duration=0.7) pyautogui.moveTo(x + 150, y + 150, duration=0.7) pyautogui.moveTo(x, y + 150, duration=0.7) pyautogui.moveTo(x, y, duration=0.7)

O exemplo baixável espera 5 segundos e faz exatamente esse percurso: um pequeno quadrado a partir da posição atual do seu mouse.

04

Clique, digite e use atalhos

pyautogui.click(600, 300) pyautogui.write('Texto automático', interval=0.05) pyautogui.hotkey('ctrl', 's')
lightbulb

O que o notebook demonstra?

No Colab criamos um desktop virtual 1280×720. O PyAutoGUI desenha com o mouse e depois preenche um formulário. É uma demonstração segura do conceito; o arquivo `.py` é o caminho simples para experimentar no seu desktop real.