PyMemoryEditor

Une bibliothèque pure-Python (construite sur ctypes) qui vous permet d'inspecter, modifier et rechercher la mémoire de n'importe quel processus en cours d'exécution en quelques lignes de Python — les workflows de Cheat Engine sur Windows, Linux et macOS !

Lisez, écrivez et scannez la mémoire de n'importe quel processus — directement depuis Python.
Une API unifiée. Trois systèmes d'exploitation. Aucun compilateur C. Aucune étape de compilation native.

Fonctionne sur Windows · Linux · macOS — 32 bits et 64 bits.

PyMemoryEditor app attached to a running process

Modifiez une valeur dans un jeu en cours d'exécution · inspectez l'état d'un programme en direct · récoltez des données directement depuis la RAM.

Installation

pip install PyMemoryEditor

Pour installer également l'application GUI incluse (un scanner de type Cheat Engine), utilisez l'extra app :

pip install "PyMemoryEditor[app]"
pymemoryeditor

Pour des scans plus rapides sur les gros processus, ajoutez l'extra speed. Il intègre NumPy et vectorise automatiquement la boucle de comparaison des scans numériques — environ 10 à 30× plus rapide sur les scans sélectifs :

pip install "PyMemoryEditor[speed]"

Pour permettre à un assistant IA de piloter la bibliothèque via le Model Context Protocol, utilisez l'extra mcp (voir ci-dessous) :

pip install "PyMemoryEditor[mcp]"

📖 Guide complet sur Read the Docs.

Voyez-le en action

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)

C'est tout — lisez, écrivez ou scannez un autre processus en trois lignes, de la même manière sur chaque plateforme.

Laissez un assistant IA le faire (MCP)

PyMemoryEditor fournit un serveur Model Context Protocol, afin qu'un assistant IA puisse exécuter toute la boucle lui-même :

« Trouve la valeur de santé dans mon jeu. Elle est à 100 actuellement. »

Il scanne, vous demande de subir des dégâts, affine les correspondances et vous donne l'adresse.

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

Ou dans n'importe quel client qui lit le JSON mcpServers (Claude Desktop, éditeurs, …) :

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

Quatorze outils couvrent l'ensemble du workflow, avec les résultats de scan conservés côté serveur derrière un handle, de sorte qu'un premier scan de 40 000 correspondances coûte quelques tokens au lieu de tout votre contexte.

Consultez le guide MCP pour en savoir plus.

📖 Documentation

La documentation complète se trouve sur pymemoryeditor.readthedocs.io — installation, le workflow Cheat Engine, chaque méthode et paramètre, le guide de l'application GUI, les notes par plateforme et le dépannage.

Un aperçu rapide de où aller :

Quick Start	Ouvrez un processus, lisez, écrivez et lancez votre premier scan.
Recherche en mémoire	Scans de valeurs, plages, affinement des résultats, la boucle Cheat Engine.
Pattern scan	Trouvez du code/des données avec des signatures d'octets (AOB) et des regex.
Pointeurs	Chaînes de pointeurs multi-niveaux et le `RemotePointer` en direct.
Pointer scan	Trouvez des pointeurs statiques qui survivent à l'ASLR.
L'application GUI	Le scanner de type Cheat Engine inclus.
Le serveur MCP	Laissez un assistant IA piloter la boucle scan/affinage.
Référence API	Chaque classe, méthode et paramètre publics.
Notes par plateforme	Permissions et particularités sur Windows, Linux et macOS.
Dépannage	Erreurs courantes et comment les corriger.

Que puis-je construire avec ceci ?

🎮 Outils de modding de jeux et de speedrun — le cas d'usage classique de Cheat Engine.
🔬 Débogage et introspection — inspectez l'état en direct sans attacher de débogueur.
📊 Outils d'observabilité — échantillonnez des variables dans un processus en cours pour la télémétrie.
🔐 Recherche en sécurité et reverse-engineering — sur des systèmes que vous possédez ou êtes autorisé à tester.
🎓 Apprentissage — l'application incluse est un excellent outil pédagogique pour comprendre le fonctionnement du scan de mémoire.

[!NOTE] Usage responsable. PyMemoryEditor communique avec d'autres processus via les API au niveau de l'OS. Ne le pointez que vers des processus que vous possédez ou que vous avez l'autorisation explicite d'inspecter.

🤝 Contribution

Les pull requests, rapports de bugs et idées de fonctionnalités sont les bienvenus. Lisez CONTRIBUTING.md pour la configuration de développement, l'organisation des tests et le petit ensemble de particularités spécifiques aux plateformes à connaître.

Si PyMemoryEditor a aidé votre projet, merci de ⭐ le dépôt — c'est la façon la plus simple de soutenir le travail et d'aider les autres à découvrir la bibliothèque.

Licence

Publié sous la MIT License — libre pour un usage personnel et commercial.

Lire plus

PyMemoryEditor v2.2.0

Catégories