PyMemoryEditor

Una libreria puramente Python (basata su ctypes) che ti permette di ispezionare, modificare e cercare nella memoria di qualsiasi processo in esecuzione con poche righe di Python — flussi di lavoro in stile Cheat Engine su Windows, Linux e macOS!

---

Leggi, scrivi e scansiona la memoria di qualsiasi processo — direttamente da Python.
Un'unica API unificata. Tre sistemi operativi. Nessun compilatore C. Nessuna fase di build nativa.

Funziona su Windows · Linux · macOS — a 32 e 64 bit.

Modifica un valore in un gioco in esecuzione · ispeziona lo stato di un programma attivo · raccogli dati direttamente dalla RAM.

---

Installazione

pip install PyMemoryEditor

Per installare anche l'app GUI inclusa (uno scanner in stile Cheat Engine), usa l'extra app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Per scansioni più veloci su processi di grandi dimensioni, aggiungi l'extra speed. Include NumPy e vettorizza automaticamente il ciclo di confronto delle scansioni numeriche — circa 10–30× più veloce sulle scansioni selettive:

pip install "PyMemoryEditor[speed]"

Per permettere a un assistente AI di pilotare la libreria tramite il Model Context Protocol, usa l'extra mcp (vedi sotto):

pip install "PyMemoryEditor[mcp]"

📖 Guida completa su Read the Docs.

---

Vederlo in azione

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)

Tutto qui — leggi, scrivi o scansiona un altro processo in tre righe, allo stesso modo su ogni piattaforma.

---

Lascia che lo faccia un assistente AI (MCP)

PyMemoryEditor include un server Model Context Protocol, così un assistente AI può eseguire l'intero ciclo da solo:

"Trova il valore della salute nel mio gioco. Adesso è 100."

Esegue la scansione, ti chiede di subire danni, affina le corrispondenze e ti consegna l'indirizzo.

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

Oppure in qualsiasi client che legge il JSON mcpServers (Claude Desktop, editor, …):

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

Quattordici strumenti coprono l'intero flusso di lavoro, con i risultati delle scansioni mantenuti lato server dietro un handle, così una prima scansione con 40 000 risultati costa pochi token invece dell'intero contesto.

Leggi la guida MCP per saperne di più.

---

📖 Documentazione

La documentazione completa è disponibile su pymemoryeditor.readthedocs.io — installazione, il flusso di lavoro in stile Cheat Engine, ogni metodo e parametro, la guida all'app GUI, note sulle piattaforme e risoluzione dei problemi.

Una mappa rapida di dove andare:

Quick Start	Apri un processo, leggi, scrivi ed esegui la tua prima scansione.
Ricerca nella memoria	Scansioni di valori, intervalli, affinamento dei risultati, il ciclo di Cheat Engine.
Pattern scan	Trova codice/dati con firme di byte (AOB) e regex.
Puntatori	Catene di puntatori multilivello e il RemotePointer live.
Pointer scan	Trova puntatori statici che sopravvivono all'ASLR.
L'app GUI	Lo scanner incluso in stile Cheat Engine.
Il server MCP	Lascia che un assistente AI gestisca il ciclo scan/refine.
Riferimento API	Ogni classe pubblica, metodo e parametro.
Note sulle piattaforme	Permessi e particolarità su Windows, Linux e macOS.
Risoluzione dei problemi	Errori comuni e come risolverli.

---

Cosa posso costruire con questo?

• 🎮 Strumenti per il modding di giochi e speedrunning — il classico caso d'uso di Cheat Engine.
• 🔬 Debugging e introspezione — ispeziona lo stato live senza collegare un debugger.
• 📊 Strumenti di osservabilità — campiona variabili in un processo in esecuzione per la telemetria.
• 🔐 Ricerca sulla sicurezza e reverse-engineering — su sistemi di tua proprietà o che sei autorizzato a testare.
• 🎓 Apprendimento — l'app inclusa è un ottimo strumento didattico per capire come funziona la scansione della memoria.

[!NOTE] Uso responsabile. PyMemoryEditor comunica con altri processi tramite API a livello di sistema operativo. Puntalo solo verso processi di tua proprietà o che hai esplicita autorizzazione a ispezionare.

---

🤝 Contribuire