Pestinha

Pets de tela para Windows, macOS e Linux, cada um com o próprio cérebro. São dois personagens por enquanto:

• Bryan, o original: uma telinha com dois olhos que mora no seu monitor principal. Cai, quica, pousa nas barras de título das janelas, brinca com uma bolinha, trabalha num notebook quando você programa, apronta com memes e post-its, protesta contra o cursor quando fica bravo e aprende com o seu carinho.
• Jorge, um personagem de sátira: um "coach" de finanças e IA que vive tentando vender mentorias para quem está na frente do computador. Jorge não é uma referência a nenhum coach, empresa ou pessoa real. É um personagem inventado para fazer piada com a cultura de promessas de enriquecimento rápido. Não vende, cobra nem pede nada de ninguém.

Os dois têm a mesma rede neural, mas cada um tem seu temperamento, seu conteúdo e sua memória, separados. Quem decide o que o pet sente e faz é uma rede neural pulsada de 470 neurônios (integração e disparo com vazamento), alimentada pelo que acontece no seu computador e pelo que você faz com ele. Algumas regras do programa (limiares, o que pode ou não acontecer) são escritas à mão; a seção Como a decisão funciona explica o que é aprendido e o que é regra.

Projeto em desenvolvimento. Algumas coisas podem não funcionar direito e o comportamento pode mudar entre versões.

Cada personagem é um pets/<pet>.json (quem ele é) mais uma pasta pets/<pet>/ (as frases, cartazes e memes dele). Todos usam a mesma rede neural, mas cada um tem a própria memória: o que um aprende não passa para o outro. Você escolhe o personagem em Configurações; a troca vale na próxima vez que abrir. Para criar um, veja pets/README.md.

Tudo o que ele aprende (carinho, condicionamento, o que deu certo nas travessuras, fugas do castigo) fica salvo localmente e muda o jeito dele com o tempo.

• Windows 10 ou 11, macOS (Quartz/pyobjc) ou Linux com X11.
• Python 3.11 ou mais novo.
• No Linux, para as janelas e o tempo ocioso: xdotool, wmctrl e xprintidle. Sem eles, o pet continua andando, mas não enxerga as janelas.
• Cerca de 70 MB de RAM com ele rodando.

pip install -r requirements.txt

python main.py

Na primeira vez, um passo a passo explica o que ele vê e não vê, e depois abre a tela de permissões. Depois de clicar em Começar, as próximas aberturas vão direto para o pet. A tela volta a aparecer se o pânico tiver desligado o programa. Para abrir a tela de propósito:

python main.py --configurar

Com o programa aberto, as opções também ficam em Configurações, no ícone da bandeja. No Windows, é lá que se marca Abrir o Pestinha ao entrar no Windows. Só uma cópia abre por vez.

Ctrl + Alt + Shift + B desliga tudo na hora, e ele continua desligado até você religar em Configurações.

Desligado por padrão. Ligado, os tempos ficam curtos (emoções, travessuras e protesto acontecem em segundos), os painéis de desenvolvimento ficam na tela (monitor neural e painel de protesto) e o terminal mostra as decisões.

Ele roda só no seu computador e não envia nada para a internet. Lê o nome do programa em primeiro plano, o tempo sem usar teclado e mouse, a posição do cursor e a geometria das janelas. Nunca lê conteúdo nem título de janela. Tudo o que ele grava fica na pasta de dados e pode ser apagado pela tela de configurações: memory/, rodando pelo código, ou %LOCALAPPDATA%\Pestinha, no executável do Windows. Detalhes em PRIVACIDADE.md.

• Memes, recadinhos e cartazes do Bryan: pasta pets/bryan/, explicada em pets/README.md. Pode editar com ele aberto.
• Bolinhas, notebook e suas fotos: assets/comum/, valem para qualquer personagem (assets/LEIA-ME.txt).
• Programas que ele reconhece: assets/comum/programas.json soma programas à lista de trabalho, jogo, música etc.
• Personalidade: pets/bryan.json (semente da rede, temperamento, pesos de brincadeira, reação ao notebook).
• Números do comportamento: pestinha/ajustes.py, todos validados ao abrir.

• docs/ARQUITETURA.md: como as partes conversam.
• docs/REDE_NEURAL.md: canais, interneurônios, motores e decisões da rede.
• pestinha/README.md e o README de cada pasta: o que cada arquivo faz.
• CONTRIBUTING.md: como rodar os testes e contribuir.
• CHANGELOG.md: o que mudou.

pip install -r requirements-dev.txt

python -m pytest -q

Os testes rodam sem abrir janelas (Qt em modo offscreen). Mais detalhes em CONTRIBUTING.md.

Há duas formas: gerar no seu computador (só o sistema em que você está) ou deixar o GitHub gerar os três. O PyInstaller só gera o executável do sistema onde roda, por isso um Windows não gera o de Mac.

1. Instale as dependências de desenvolvimento (inclui o PyInstaller):

   pip install -r requirements-dev.txt

2. Gere o executável, no Windows:

   python -m PyInstaller --noconfirm --onefile --windowed --name Pestinha --distpath build/onefile --workpath build/work --specpath build --hidden-import win32timezone main.py

   No macOS e no Linux, use o mesmo comando sem --windowed e sem --hidden-import win32timezone.

3. O resultado fica em build/onefile/ (Pestinha.exe no Windows, Pestinha nos outros).

4. Monte a pasta de entrega: copie o executável e as pastas assets/ e pets/ para uma mesma pasta. O programa lê o conteúdo dessas pastas ao lado do executável. No Windows, a memória fica em %LOCALAPPDATA%\Pestinha, a menos que já exista uma pasta memory/ ao lado dele. Nos outros sistemas, a memory/ é criada sozinha na primeira execução, então não copie a sua.

5. Opcional, no Windows: gere o instalador com o Inno Setup 6. Ele usa o executável do passo 3, instala só para o usuário atual e não pede administrador:

   ISCC instalador/pestinha.iss

   O resultado fica em instalador/saida/.

O workflow .github/workflows/executaveis.yml gera Windows, macOS e Linux em máquinas do próprio GitHub.

1. Suba o repositório para o GitHub (git push).

2. Para gerar sem criar versão: na aba Actions, escolha executáveis, clique em Run workflow.

3. Para gerar e publicar uma versão: crie uma tag e envie. Por exemplo:

   git tag v0.8.0
   git push origin v0.8.0

4. Ao terminar (alguns minutos), a execução tem três artefatos, um por sistema, com a pasta pronta (executável + assets/ + pets/). Baixe pela própria página da execução, na seção Artifacts.

Para distribuir para quem não é do projeto, publique esses artefatos na aba Releases (use "Draft a new release" na tag criada), e não dentro do repositório: cada executável tem cerca de 60 MB.

• Para testar sem misturar com a sua memória, crie uma pasta memory/ vazia ao lado do executável de teste.
• O executável não é assinado: o Windows e o macOS avisam na primeira execução. No macOS, a permissão de Acessibilidade é necessária para o atalho Ctrl+Alt+Shift+B; no Linux, o atalho e as janelas precisam de xdotool, wmctrl e xprintidle.

O código do Pestinha é software livre, sob a GNU General Public License v3.0 ou posterior (GPL-3.0-or-later). Você pode usar, estudar, modificar e redistribuir, mas toda versão distribuída, modificada ou não, precisa continuar aberta e sob a mesma licença.

As imagens e os textos de assets/ não estão cobertos por esta licença

• macOS e Linux ainda não foram testados numa máquina real: a parte de leitura das janelas e do teclado foi escrita e testada só nas partes de texto (ver tests/test_plataforma.py).
• No macOS, o pet precisa da permissão de Acessibilidade para o atalho Ctrl+Alt+Shift+B funcionar.
• No Linux com Wayland, o pet não enxerga janelas nem o tempo ocioso, e o atalho global não funciona.
• Pouco testado com escala de tela acima de 100% e com vários monitores. A tela cheia num monitor esconde o pet em todos.
• Jogos em janela sem borda podem não ser detectados como tela cheia.
• O executável não é assinado; o Windows pode avisar na primeira execução.