PyMemoryEditor

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 com 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 — direto do Python.
Uma API unificada. Três sistemas operacionais. Sem compilador C. Sem etapa de build nativa.

Roda 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 · colete dados direto da RAM.

---

Instalação

pip install PyMemoryEditor

Para também instalar 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]"

Para permitir que um assistente de IA conduza a biblioteca pelo 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 loop sozinho:

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

Ele escaneia, pede que você sofra 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 JSON mcpServers (Claude Desktop, editores, …):

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

Quatorze ferramentas cobrem todo o fluxo de trabalho, com resultados de varredura mantidos no lado do servidor por trás de um handle, para que uma primeira varredura com 40.000 resultados custe alguns tokens em vez de todo o seu contexto.

Leia o guia MCP para saber mais.

---

📖 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.
O servidor MCP	Deixe um assistente de IA conduzir o loop de varredura/refinamento.
Referência da API	Toda classe, método e parâmetro público.
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?

• 🎮 Modding de jogos e ferramentas de speedrun — 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 fala 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 no seu projeto, por favor ⭐ o 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.