PyMemoryEditor

Uma biblioteca de Python puro (construída sobre ctypes) que permite inspecionar, modificar e pesquisar a memória de qualquer processo em execução com poucas linhas de Python — fluxos de trabalho do Cheat Engine no Windows, Linux e macOS!

Leia, escreva e analise a memória de qualquer processo — direto do Python.
Uma API unificada. Três sistemas operacionais. Sem compilador C. Sem etapa de build nativa.

Funciona em 🪟 Windows · 🐧 Linux · 🍎 macOS — 32 e 64 bits.

Ajuste um valor em um jogo em execução · inspecione o estado de um programa ao vivo · colete dados direto da RAM.

Instalação

pip install PyMemoryEditor

Para instalar também o aplicativo GUI incluído (um scanner no estilo do Cheat Engine), use o extra app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Para varreduras mais rápidas em processos grandes, adicione o extra speed. Ele inclui o NumPy e vetoriza automaticamente o loop de comparação da varredura numérica — ~10–30× mais rápido em varreduras seletivas:

pip install "PyMemoryEditor[speed]"

📖 Guia completo em Read the Docs.

Veja em ação

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # Scan the whole process for every address holding the value 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # Read the current value, then write a new one back.
    current = process.read_int(address)
    process.write_int(address, current + 500)

É isso — leia, grave ou analise outro processo em três linhas, da mesma forma em todas as plataformas.

O que está incluso

🐍 A biblioteca Python

Controle total sobre a memória de outro processo — em poucas linhas de Python:

• ✅ Leia e grave valores (int, float, bool, str, bytes)
• 🔍 Varredura por valor com oito modos de comparação
• 🎯 Varredura por padrão (AOB no estilo IDA e regex)
• 🔗 Cadeias de ponteiros + um handle RemotePointer ao vivo
• 🧭 Varredura de ponteiros — encontre ponteiros estáticos que sobrevivem ao ASLR
• 🗺️ Mapa de memória, módulos, threads
• 🧱 Aloque e libere memória remota (Windows / macOS)

🖥️ O aplicativo GUI incluído

Todo o poder da biblioteca — sem necessidade de código:

• ⚡ Zero configuração — anexe a um processo e comece a analisar em segundos
• 🧲 Fluxo de refinamento — Primeira varredura → Próxima varredura com feedback visual ao vivo
• 📋 Cheat table — congele / grave valores em tempo real, importação/exportação JSON
• 🔬 Visualizador hexadecimal — navegue pela memória bruta e aplique alterações diretamente
• 🧩 Interface de varredura de ponteiros — analise, exporte e revise em várias sessões com poucos cliques
• 🎨 Acesso com um clique — todos os recursos ao seu alcance, sem necessidade de código

📖 Documentação

A documentação completa está em pymemoryeditor.readthedocs.io — instalação, o fluxo de trabalho do Cheat Engine, todos os métodos e parâmetros, o guia do aplicativo GUI, notas de plataforma e solução de problemas.

Um mapa rápido de por onde ir:

O que posso construir com isso?

• 🎮 Ferramentas de modding e speedrunning de jogos — o caso de uso clássico do Cheat Engine.
• 🔬 Depuração e introspecção — inspecione o estado ao vivo sem anexar um depurador.
• 📊 Ferramentas de observabilidade — colete amostras de variáveis em um processo em execução para telemetria.
• 🔐 Pesquisa em segurança e engenharia reversa — em sistemas que você possui ou tem autorização para testar.
• 🎓 Aprendizado — o aplicativo incluído é uma ótima ferramenta de ensino para entender como funciona a varredura de memória.

[!NOTE] Uso responsável. O PyMemoryEditor se comunica com outros processos por meio de APIs de nível de sistema operacional. Aponte-o apenas para processos que você possui ou para os quais tem permissão explícita de inspeção.

🤝 Contribuindo

Pull requests, relatórios de bugs e ideias de recursos são muito bem-vindos. Leia o CONTRIBUTING.md para conhecer a configuração de desenvolvimento, a organização dos testes e o pequeno conjunto de peculiaridades específicas de plataforma que você deve observar.

Se o PyMemoryEditor ajudou seu projeto, por favor, dê uma ⭐ no repositório — é a maneira mais fácil de apoiar o trabalho e ajudar outras pessoas a descobrir a biblioteca.

Licença

Publicado sob a Licença MIT — gratuito para uso pessoal e comercial.