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:

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

Pull request, segnalazioni di bug e idee per nuove funzionalità sono molto benvenute. Leggi CONTRIBUTING.md per la configurazione di sviluppo, l'organizzazione dei test e il piccolo insieme di particolarità specifiche della piattaforma di cui essere consapevoli.

Se PyMemoryEditor è stato utile al tuo progetto, metti una ⭐ al repo — è il modo più semplice per sostenere il lavoro e aiutare altri a scoprire la libreria.

Licenza

Rilasciato sotto la MIT License — gratuito per uso personale e commerciale.