PyMemoryEditor

Uma biblioteca puramente em Python (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 do Cheat Engine no Windows, Linux e macOS!

Leia, escreva e escaneie a memória de qualquer processo — diretamente 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.

PyMemoryEditor app attached to a running process

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

Instalação

pip install PyMemoryEditor

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

pip install "PyMemoryEditor[app]"
pymemoryeditor

Para escaneamentos mais rápidos em processos grandes, adicione o extra speed. Ele traz o NumPy e vetoriza automaticamente o loop de comparação de escaneamento numérico — cerca de 10–30× mais rápido em escaneamentos seletivos:

pip install "PyMemoryEditor[speed]"

Para permitir que um assistente de IA controle a biblioteca através do Model Context Protocol, use o extra mcp (veja abaixo):

pip install "PyMemoryEditor[mcp]"

📖 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, escreva ou escaneie outro processo em três linhas, da mesma forma em todas as plataformas.

Deixe um assistente de IA fazer isso (MCP)

O PyMemoryEditor inclui um servidor Model Context Protocol, para que um assistente de IA possa executar todo o ciclo sozinho:

"Encontre o valor de vida no meu jogo. Está em 100 agora."

Ele escaneia, pede que você tome dano, refina as correspondências e entrega o endereço.

pip install "PyMemoryEditor[mcp]"
claude mcp add pymemoryeditor -- pymemoryeditor-mcp

Ou em qualquer cliente que leia o JSON de mcpServers (Claude Desktop, editores, …):

{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "pymemoryeditor-mcp",
      "args": []
    }
  }
}

Quatorze ferramentas cobrem todo o fluxo de trabalho, com os resultados do escaneamento mantidos no lado do servidor atrás de um handle, de modo que um primeiro escaneamento com 40 000 resultados custa alguns tokens em vez de todo o seu contexto.

Leia o guia do MCP para saber mais.

📖 Documentação

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

Um mapa rápido de onde ir:

Quick Start	Abra um processo, leia, escreva e execute seu primeiro escaneamento.
Searching memory	Escaneamentos de valores, intervalos, refinamento de resultados, o ciclo do Cheat Engine.
Pattern scan	Encontre código/dados com assinaturas de bytes (AOB) e regex.
Pointers	Cadeias de ponteiros multinível e o `RemotePointer` ao vivo.
Pointer scan	Encontre ponteiros estáticos que sobrevivem ao ASLR.
The GUI app	O scanner incluído no estilo Cheat Engine.
The MCP server	Deixe um assistente de IA conduzir o ciclo de escaneamento/refinamento.
API reference	Cada classe, método e parâmetro público.
Platform notes	Permissões e peculiaridades no Windows, Linux e macOS.
Troubleshooting	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 o escaneamento de memória.

[!NOTE] Uso responsável. O PyMemoryEditor se comunica com outros processos através de APIs de nível de sistema operacional. Aponte-o apenas para processos que você possui ou tem permissão explícita para inspecionar.

🤝 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 consideradas.

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

Licença

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

Ler mais

PyMemoryEditor v2.2.0

Categorias