jeanextreme002/pymemoryeditorUne bibliothèque pure Python qui permet d'inspecter, de modifier et de rechercher la mémoire de n'importe quel processus en cours d'exécution en quelques lignes de Python 🐍 .
# PyMemoryEditor
<!-- mcp-name: io.github.JeanExtreme002/PyMemoryEditor -->
Une bibliothèque pure Python (construite sur [ctypes](https://docs.python.org/3/library/ctypes.html)) 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 !
---
<p align="center">
<img src="https://raw.githubusercontent.com/JeanExtreme002/PyMemoryEditor/main/PyMemoryEditor/app/assets/icon.svg" alt="PyMemoryEditor logo" width="120" />
</p>
<p align="center">
<b>Lisez, écrivez et scannez la mémoire de n'importe quel processus — directement depuis Python.</b><br>
<i>Une API unifiée. Trois systèmes d'exploitation. Aucun compilateur C. Aucune étape de compilation native.</i>
</p>
<p align="center">
<a href="https://github.com/JeanExtreme002/PyMemoryEditor/actions/workflows/python-package.yml"><img src="https://github.com/JeanExtreme002/PyMemoryEditor/actions/workflows/python-package.yml/badge.svg" alt="Python Package" /></a>
<a href="https://codecov.io/gh/JeanExtreme002/PyMemoryEditor"><img src="https://codecov.io/gh/JeanExtreme002/PyMemoryEditor/branch/main/graph/badge.svg" alt="Coverage" /></a>
<a href="https://pypi.org/project/PyMemoryEditor/"><img src="https://img.shields.io/pypi/v/PyMemoryEditor" alt="Pypi" /></a>
<a href="https://github.com/JeanExtreme002/PyMemoryEditor"><img src="https://img.shields.io/pypi/l/PyMemoryEditor" alt="License" /></a>
<a href="https://github.com/JeanExtreme002/PyMemoryEditor"><img src="https://img.shields.io/badge/python-3.10+-8A2BE2" alt="Python Version" /></a>
<a href="https://pypi.org/project/PyMemoryEditor/"><img src="https://static.pepy.tech/personalized-badge/pymemoryeditor?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads" alt="Downloads" /></a>
</p>
<p align="center">
Fonctionne sur <b>Windows</b> · <b>Linux</b> · <b>macOS</b> — 32 bits et 64 bits.
</p>
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/8411/aad09c3d92b7123b753fb1b9a7950622aac7d0f84f76b1992ca3e3defc4bf050.png" alt="PyMemoryEditor app attached to a running process" width="820" />
</p>
<p align="center">
Modifiez une valeur dans un jeu en cours d'exécution · inspectez l'état d'un programme en direct ·
récupérez des données directement depuis la RAM.
</p>
---
## Installation
```bash
pip install PyMemoryEditor
```
Pour installer également l'application GUI incluse (un scanner de type Cheat Engine), utilisez l'extra `app` :
```bash
pip install "PyMemoryEditor[app]"
pymemoryeditor
```
Pour des scans plus rapides sur les gros processus, ajoutez l'extra `speed`. Il installe NumPy
et vectorise automatiquement la boucle de comparaison des scans numériques — environ 10 à 30× plus rapide sur
les scans sélectifs :
```bash
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](#let-an-ai-assistant-do-it-mcp)) :
```bash
pip install "PyMemoryEditor[mcp]"
```
📖 Guide complet sur **[Read the Docs](https://pymemoryeditor.readthedocs.io)**.
---
## Voyez-le en action
```python
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 toutes les plateformes.
---
## Laissez un assistant IA le faire (MCP)
PyMemoryEditor embarque 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.
```bash
pip install "PyMemoryEditor[mcp]"
claude mcp add pymemoryeditor -- pymemoryeditor-mcp
```
Ou dans n'importe quel client qui lit le JSON `mcpServers` (Claude Desktop, éditeurs, …) :
```json
{
"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](https://pymemoryeditor.readthedocs.io/en/latest/mcp.html) pour en savoir plus.
---
## 📖 Documentation
La documentation complète se trouve sur **[pymemoryeditor.readthedocs.io](https://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 :
<table>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/quickstart.html"><b>Quick Start</b></a></td><td>Ouvrez un processus, lisez, écrivez et lancez votre premier scan.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/guide/searching.html"><b>Searching memory</b></a></td><td>Scans de valeurs, plages, affinage des résultats, la boucle Cheat Engine.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/guide/pattern-scan.html"><b>Pattern scan</b></a></td><td>Trouvez du code/des données avec des signatures d'octets (AOB) et des regex.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/guide/pointers.html"><b>Pointers</b></a></td><td>Chaînes de pointeurs multi-niveaux et le <code>RemotePointer</code> en direct.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/guide/pointer-scan.html"><b>Pointer scan</b></a></td><td>Trouvez des pointeurs statiques qui survivent à l'ASLR.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/app.html"><b>The GUI app</b></a></td><td>Le scanner de type Cheat Engine inclus.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/mcp.html"><b>The MCP server</b></a></td><td>Laissez un assistant IA piloter la boucle scan/affinage.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/api/openprocess.html"><b>API reference</b></a></td><td>Chaque classe, méthode et paramètre public.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/platform-notes.html"><b>Platform notes</b></a></td><td>Permissions et particularités sur Windows, Linux et macOS.</td></tr>
<tr><td><a href="https://pymemoryeditor.readthedocs.io/en/latest/troubleshooting.html"><b>Troubleshooting</b></a></td><td>Erreurs courantes et comment les corriger.</td></tr>
</table>
---
## Que puis-je construire avec ça ?
- 🎮 **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 d'exécution pour la télémétrie.
- 🔐 **Recherche en sécurité et rétro-ingénierie** — 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]
> **Utilisation responsable.** PyMemoryEditor communique avec d'autres processus via les API du système d'exploitation.
> Ne le pointez que vers des processus que vous possédez ou que vous avez l'autorisation explicite d'inspecter.
---
## 🤝 Contribuer
Les pull requests, rapports de bugs et idées de fonctionnalités sont les bienvenus. Consultez
[`CONTRIBUTING.md`](https://github.com/JeanExtreme002/PyMemoryEditor/blob/main/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](https://github.com/JeanExtreme002/PyMemoryEditor/blob/main/LICENSE) — gratuit pour un usage personnel et commercial.