PyMemoryEditor

Una librería de Python puro (construida sobre ctypes) que te permite inspeccionar, modificar y buscar en la memoria de cualquier proceso en ejecución con unas pocas líneas de Python — ¡flujos de trabajo de Cheat Engine en Windows, Linux y macOS!

---

Lee, escribe y escanea la memoria de cualquier proceso — directamente desde Python.
Una API unificada. Tres sistemas operativos. Sin compilador de C. Sin paso de compilación nativo.

Funciona en Windows · Linux · macOS — 32 bits y 64 bits.

Ajusta un valor en un juego en ejecución · inspecciona el estado de un programa en vivo · extrae datos directamente de la RAM.

---

Instalación

pip install PyMemoryEditor

Para instalar también la aplicación GUI incluida (un escáner estilo Cheat Engine), usa el extra app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Para escaneos más rápidos en procesos grandes, añade el extra speed. Incorpora NumPy y vectoriza automáticamente el bucle de comparación de escaneo numérico — ~10–30× más rápido en escaneos selectivos:

pip install "PyMemoryEditor[speed]"

Para permitir que un asistente de IA controle la librería a través del Model Context Protocol, usa el extra mcp (ver abajo):

pip install "PyMemoryEditor[mcp]"

📖 Guía completa en Read the Docs.

---

Míralo en acción

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)

Eso es todo — lee, escribe o escanea otro proceso en tres líneas, de la misma forma en todas las plataformas.

---

Deja que un asistente de IA lo haga (MCP)

PyMemoryEditor incluye un servidor de Model Context Protocol, para que un asistente de IA pueda ejecutar todo el ciclo por sí mismo:

"Encuentra el valor de salud en mi juego. Ahora mismo es 100."

Escanea, te pide que recibas daño, refina las coincidencias y te entrega la dirección.

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

O en cualquier cliente que lea el JSON de mcpServers (Claude Desktop, editores, …):

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

Catorce herramientas cubren todo el flujo de trabajo, con los resultados de escaneo guardados en el servidor tras un handle, de modo que un primer escaneo con 40 000 coincidencias cuesta unos pocos tokens en lugar de todo tu contexto.

Lee la guía de MCP para saber más.

---

📖 Documentación

La documentación completa está en pymemoryeditor.readthedocs.io — instalación, el flujo de trabajo de Cheat Engine, cada método y parámetro, la guía de la aplicación GUI, notas de plataforma y solución de problemas.

Un mapa rápido de por dónde ir:

Quick Start	Abre un proceso, lee, escribe y ejecuta tu primer escaneo.
Searching memory	Escaneos de valores, rangos, refinado de resultados, el ciclo de Cheat Engine.
Pattern scan	Encuentra código/datos con firmas de bytes (AOB) y regex.
Pointers	Cadenas de punteros multinivel y el RemotePointer en vivo.
Pointer scan	Encuentra punteros estáticos que sobreviven a ASLR.
The GUI app	El escáner estilo Cheat Engine incluido.
The MCP server	Deja que un asistente de IA controle el ciclo de escaneo/refinado.
API reference	Cada clase, método y parámetro públicos.
Platform notes	Permisos y peculiaridades en Windows, Linux y macOS.
Troubleshooting	Errores comunes y cómo solucionarlos.

---

¿Qué puedo construir con esto?

• 🎮 Herramientas de modding de juegos y speedrunning — el caso de uso clásico de Cheat Engine.
• 🔬 Depuración e introspección — inspecciona el estado en vivo sin adjuntar un depurador.
• 📊 Herramientas de observabilidad — muestrea variables en un proceso en ejecución para telemetría.
• 🔐 Investigación de seguridad e ingeniería inversa — en sistemas que posees o estás autorizado a probar.
• 🎓 Aprendizaje — la aplicación incluida es una gran herramienta didáctica para entender cómo funciona el escaneo de memoria.

[!NOTE] Uso responsable. PyMemoryEditor se comunica con otros procesos a través de APIs a nivel de sistema operativo. Solo apúntalo a procesos que poseas o para los que tengas permiso explícito de inspeccionar.

---

🤝 Contribuir

Las pull requests, los informes de errores y las ideas de funcionalidades son muy bienvenidos. Lee CONTRIBUTING.md para la configuración de desarrollo, la estructura de pruebas y el pequeño conjunto de peculiaridades específicas de plataforma que debes conocer.