
PyMemoryEditor v2.1.0
Uma biblioteca puramente em Python que permite inspecionar, modificar e pesquisar a memória de qualquer processo em execução em poucas linhas de Python :snake: .
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
RemotePointerao 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:
| Início Rápido | Abra um processo, leia, grave e execute sua primeira varredura. |
| Pesquisando memória | Varreduras por valor, intervalos, refinamento de resultados, o loop do Cheat Engine. |
| Varredura por padrão | Encontre código/dados com assinaturas de bytes (AOB) e regex. |
| Ponteiros | Cadeias de ponteiros de vários níveis e o RemotePointer ao vivo. |
| Varredura de ponteiros | Encontre ponteiros estáticos que sobrevivem ao ASLR. |
| O aplicativo GUI | O scanner incluído no estilo do Cheat Engine. |
| Referência da API | Todas as classes, métodos e parâmetros públicos. |
| Notas de plataforma | Permissões e peculiaridades no Windows, Linux e macOS. |
| Solução de problemas | Erros comuns e como corrigi-los. |
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.