PyMemoryEditor

Чистая библиотека на Python (построенная на ctypes), которая позволяет исследовать, изменять и искать в памяти любого запущенного процесса всего в несколько строк Python — рабочие процессы Cheat Engine на Windows, Linux и macOS!

Читайте, записывайте и сканируйте память любого процесса — прямо из Python.
Единый API. Три операционные системы. Без C-компилятора. Без этапа нативной сборки.

Работает на Windows · Linux · macOS — 32-бит и 64-бит.

PyMemoryEditor app attached to a running process

Измените значение в запущенной игре · исследуйте состояние работающей программы · извлекайте данные прямо из оперативной памяти.

Установка

pip install PyMemoryEditor

Чтобы также установить встроенное GUI-приложение (сканер в стиле Cheat Engine), используйте extra app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Для более быстрого сканирования больших процессов добавьте extra speed. Он подтягивает NumPy и автоматически векторизует цикл сравнения при числовом сканировании — примерно в 10–30 раз быстрее при выборочном сканировании:

pip install "PyMemoryEditor[speed]"

Чтобы позволить AI-ассистенту управлять библиотекой через Model Context Protocol, используйте extra mcp (см. ниже):

pip install "PyMemoryEditor[mcp]"

📖 Полное руководство на Read the Docs.

Посмотрите в действии

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)

Вот и всё — читайте, записывайте или сканируйте другой процесс в три строки, одинаково на каждой платформе.

Пусть это сделает AI-ассистент (MCP)

PyMemoryEditor поставляется с сервером Model Context Protocol, так что AI-ассистент может сам выполнить весь цикл:

«Найди значение здоровья в моей игре. Сейчас оно равно 100.»

Он сканирует, просит вас получить урон, уточняет совпадения и выдаёт вам адрес.

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

Или в любом клиенте, который читает JSON mcpServers (Claude Desktop, редакторы, …):

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

Четырнадцать инструментов покрывают весь рабочий процесс, а результаты сканирования хранятся на стороне сервера за дескриптором, поэтому первое сканирование с 40 000 попаданий стоит несколько токенов вместо всего вашего контекста.

Читайте руководство по MCP, чтобы узнать больше.

📖 Документация

Полная документация находится на pymemoryeditor.readthedocs.io — установка, рабочий процесс Cheat Engine, каждый метод и параметр, руководство по GUI-приложению, заметки по платформам и устранение неполадок.

Краткая карта, куда обратиться:

Quick Start	Откройте процесс, читайте, записывайте и запустите первое сканирование.
Searching memory	Сканирование значений, диапазоны, уточнение результатов, цикл Cheat Engine.
Pattern scan	Поиск кода/данных с помощью байтовых сигнатур (AOB) и регулярных выражений.
Pointers	Многоуровневые цепочки указателей и живой `RemotePointer`.
Pointer scan	Поиск статических указателей, переживающих ASLR.
The GUI app	Встроенный сканер в стиле Cheat Engine.
The MCP server	Позвольте AI-ассистенту управлять циклом сканирования/уточнения.
API reference	Каждый публичный класс, метод и параметр.
Platform notes	Разрешения и особенности на Windows, Linux и macOS.
Troubleshooting	Распространённые ошибки и способы их исправления.

Что я могу с этим создать?

🎮 Инструменты для моддинга игр и спидраннинга — классический сценарий использования Cheat Engine.
🔬 Отладка и интроспекция — исследуйте живое состояние без подключения отладчика.
📊 Инструменты наблюдаемости — сэмплируйте переменные в работающем процессе для телеметрии.
🔐 Исследования в области безопасности и реверс-инжиниринга — на системах, которыми вы владеете или которые вам разрешено тестировать.
🎓 Обучение — встроенное приложение — отличный учебный инструмент для понимания того, как работает сканирование памяти.

[!NOTE] Ответственное использование. PyMemoryEditor взаимодействует с другими процессами через API уровня ОС. Направляйте его только на процессы, которыми вы владеете или которые вам явно разрешено исследовать.

🤝 Участие в разработке

Pull requests, сообщения об ошибках и идеи новых функций очень приветствуются. Прочитайте CONTRIBUTING.md, чтобы узнать о настройке разработки, структуре тестов и небольшом наборе платформенно-специфичных особенностей, о которых стоит знать.

Если PyMemoryEditor помог вашему проекту, пожалуйста, поставьте ⭐ репозиторию — это самый простой способ поддержать работу и помочь другим найти библиотеку.

Лицензия

Выпущено под MIT License — бесплатно для личного и коммерческого использования.

PyMemoryEditor v2.2.0

Категории