PyMemoryEditor

Eine reine Python-Bibliothek (aufgebaut auf ctypes), mit der du den Speicher jedes laufenden Prozesses mit wenigen Zeilen Python inspizieren, verändern und durchsuchen kannst — Cheat-Engine-Workflows unter Windows, Linux und macOS!

Lies, schreibe und scanne den Speicher jedes Prozesses — direkt aus Python.
Eine einheitliche API. Drei Betriebssysteme. Kein C-Compiler. Kein nativer Build-Schritt.

Läuft unter Windows · Linux · macOS — 32-Bit und 64-Bit.

Ändere einen Wert in einem laufenden Spiel · inspiziere den Zustand eines Live-Programms · sammle Daten direkt aus dem RAM.

Installation

pip install PyMemoryEditor

Um zusätzlich die mitgelieferte GUI-App zu installieren (ein Scanner im Cheat-Engine-Stil), verwende das app-Extra:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Für schnellere Scans bei großen Prozessen füge das speed-Extra hinzu. Es zieht NumPy hinzu und vektorisiert automatisch die Vergleichsschleife für numerische Scans — ~10–30× schneller bei selektiven Scans:

pip install "PyMemoryEditor[speed]"

Damit ein KI-Assistent die Bibliothek über das Model Context Protocol steuern kann, verwende das mcp-Extra (siehe unten):

pip install "PyMemoryEditor[mcp]"

📖 Vollständige Anleitung unter Read the Docs.

In Aktion

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)

Das war's — lies, schreibe oder scanne einen anderen Prozess in drei Zeilen, auf jeder Plattform gleich.

Lass einen KI-Assistenten das übernehmen (MCP)

PyMemoryEditor liefert einen Model Context Protocol-Server mit, sodass ein KI-Assistent die gesamte Schleife selbst ausführen kann:

"Finde den Health-Wert in meinem Spiel. Er ist gerade 100."

Er scannt, bittet dich, Schaden zu nehmen, verfeinert die Treffer und übergibt dir die Adresse.

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

Oder in jedem Client, der mcpServers-JSON liest (Claude Desktop, Editoren, …):

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

Vierzehn Tools decken den vollständigen Workflow ab, wobei Scan-Ergebnisse serverseitig hinter einem Handle gehalten werden, sodass ein erster Scan mit 40 000 Treffern nur ein paar Token kostet statt deines gesamten Kontexts.

Lies die MCP-Anleitung, um mehr zu erfahren.

📖 Dokumentation

Die vollständige Dokumentation findest du unter pymemoryeditor.readthedocs.io — Installation, der Cheat-Engine-Workflow, jede Methode und jeder Parameter, die Anleitung zur GUI-App, Plattformhinweise und Fehlerbehebung.

Eine kurze Übersicht, wo du was findest:

Was kann ich damit bauen?

• 🎮 Game-Modding- & Speedrunning-Tools — der klassische Cheat-Engine-Anwendungsfall.
• 🔬 Debugging & Introspektion — inspiziere den Live-Zustand, ohne einen Debugger anzuhängen.
• 📊 Observability-Tooling — sample Variablen in einem laufenden Prozess für Telemetrie.
• 🔐 Security- & Reverse-Engineering-Forschung — auf Systemen, die dir gehören oder die du autorisiert testen darfst.
• 🎓 Lernen — die mitgelieferte App ist ein großartiges Lehrwerkzeug dafür, wie Memory-Scanning funktioniert.

[!NOTE] Verantwortungsvolle Nutzung. PyMemoryEditor kommuniziert über OS-Level-APIs mit anderen Prozessen. Richte es nur auf Prozesse, die dir gehören oder die du ausdrücklich inspizieren darfst.

🤝 Mitwirken

Pull Requests, Bug-Reports und Feature-Ideen sind sehr willkommen. Lies CONTRIBUTING.md für das Entwicklungs-Setup, den Testaufbau und die kleine Menge plattformspezifischer Eigenheiten, die zu beachten sind.

Wenn PyMemoryEditor deinem Projekt geholfen hat, gib dem Repo bitte einen ⭐ — das ist der einfachste Weg, die Arbeit zu unterstützen und anderen zu helfen, die Bibliothek zu entdecken.

Lizenz

Veröffentlicht unter der MIT-Lizenz — kostenlos für persönliche und kommerzielle Nutzung.