PyMemoryEditor v2.2.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 Python pura (construída sobre ctypes) que permite inspecionar, modificar e pesquisar a memória de qualquer processo em execução em poucas linhas de Python — fluxos de trabalho estilo Cheat Engine no Windows, Linux e macOS!
Leia, escreva e faça varreduras na 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 bits e 64 bits.
Ajuste um valor em um jogo em execução · inspecione o estado de um programa ao vivo · extraia dados direto da RAM.
Instalação
pip install PyMemoryEditor
Para instalar também o aplicativo GUI incluído (um scanner estilo 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 NumPy
e vetoriza automaticamente o loop de comparação de 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:
# Varre todo o processo em busca de todos os endereços que contêm o valor 100.
for address in process.search_by_value(int, value=100):
print(f"Encontrado em 0x{address:X}")
# Lê o valor atual e escreve um novo de volta.
current = process.read_int(address)
process.write_int(address, current + 500)
É isso — leia, escreva ou faça varreduras em outro processo em três linhas, da mesma forma em todas as plataformas.
📖 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 onde ir:
| Início rápido | Abra um processo, leia, escreva e execute sua primeira varredura. |
| Pesquisando memória | Varreduras de valor, intervalos, refinamento de resultados, o loop do Cheat Engine. |
| Varredura de padrão | Encontre código/dados com assinaturas de bytes (AOB) e regex. |
| Ponteiros | Cadeias de ponteiros multinível e o RemotePointer ao vivo. |
| Varredura de ponteiros | Encontre ponteiros estáticos que sobrevivem ao ASLR. |
| O aplicativo GUI | O scanner estilo Cheat Engine incluído. |
| 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 de jogos e speedrunning — 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 — amostre variáveis em um processo em execução para telemetria.
- 🔐 Pesquisa de segurança e engenharia reversa — em sistemas que você possui ou está autorizado a testar.
- 🎓 Aprendizado — o aplicativo incluído é uma ótima ferramenta de ensino sobre 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
CONTRIBUTING.md para a configuração de desenvolvimento, a estrutura de testes e
o pequeno conjunto de peculiaridades específicas de plataforma a serem observadas.
Se o PyMemoryEditor ajudou seu projeto, por favor, dê ⭐ no repositório — é a maneira mais fácil de apoiar o trabalho e ajudar outras pessoas a descobrir a biblioteca.
Licença
Lançado sob a Licença MIT — livre para uso pessoal e comercial.