PyMemoryEditor

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 estilo 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 nativa.

Funciona en Windows · Linux · macOS — de 32 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. Incluye 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 maneje 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.

---

Véalo 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 manera en cada plataforma.

---

Deja que un asistente de IA lo haga (MCP)

PyMemoryEditor incluye un servidor Model Context Protocol, para que un asistente de IA pueda ejecutar todo el bucle 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 JSON mcpServers (Claude Desktop, editores, …):

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

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

Lee la guía de MCP para aprender 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 dónde ir:

Inicio rápido	Abre un proceso, lee, escribe y ejecuta tu primer escaneo.
Búsqueda en memoria	Escaneos de valores, rangos, refinamiento de resultados, el bucle de Cheat Engine.
Escaneo de patrones	Encuentra código/datos con firmas de bytes (AOB) y regex.
Punteros	Cadenas de punteros multinivel y el RemotePointer en vivo.
Escaneo de punteros	Encuentra punteros estáticos que sobreviven a ASLR.
La aplicación GUI	El escáner incluido estilo Cheat Engine.
El servidor MCP	Deja que un asistente de IA maneje el bucle de escaneo/refinamiento.
Referencia de API	Cada clase, método y parámetro público.
Notas de plataforma	Permisos y peculiaridades en Windows, Linux y macOS.
Solución de problemas	Errores comunes y cómo solucionarlos.

---

¿Qué puedo construir con esto?

• 🎮 Modding de juegos y herramientas de 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. Apúntalo solo a procesos que poseas o para los que tengas permiso explícito de inspección.

---

🤝 Contribuciones

Las solicitudes de extracción, informes de errores e ideas de funciones son muy bienvenidas. Lee CONTRIBUTING.md para la configuración de desarrollo, la estructura de pruebas y el pequeño conjunto de peculiaridades específicas de plataforma a tener en cuenta.

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

---

Licencia

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