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:

¿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.

Si PyMemoryEditor ayudó a tu proyecto, por favor dale una ⭐ al repositorio — es la forma más fácil de apoyar el trabajo y de ayudar a otros a descubrir la librería.

Licencia

Publicado bajo la Licencia MIT — gratis para uso personal y comercial.