pip install pypdfium2 pillow numpy requests

Дополнительно, под нужные движки:

pip install easyocr           # для EasyOCR (GPU)
pip install pytesseract       # для Tesseract (нужен ещё установленный tesseract.exe + языки rus/eng)

Poppler НЕ нужен — рендер PDF идёт через pypdfium2.

Шаг 2. Положить плагин в папку LM Studio

Скопируйте папку qwen-pdf-ocr-plugin целиком в каталог плагинов LM Studio:

%USERPROFILE%\.lmstudio\extensions\plugins\local\qwen-pdf-ocr

(если такого пути нет — см. Шаг 2-альт ниже через CLI).

Шаг 2-альт. Через CLI (надёжнее)

• Установите CLI LM Studio: в LM Studio есть кнопка, либо npx lmstudio install-cli.
• В PowerShell зайдите в папку плагина и запустите режим разработки:

cd путь\до\qwen-pdf-ocr-plugin
lms dev

LM Studio подтянет зависимости из package.json, соберёт плагин и покажет его в списке. lms dev нужен только при разработке; установленный плагин LM Studio запускает сам.

Шаг 3. Включить плагин и проверить настройки

• В LM Studio откройте раздел Program / Plugins (или вкладку с плагинами).
• Найдите qwen-pdf-ocr и включите тумблер.
• Нажмите шестерёнку настроек плагина и проверьте:
  • какие движки включены (Qwen3-VL / EasyOCR / Tesseract);
  • языки (ru,en), DPI, путь к Python;
  • для Qwen3-VL — URL сервера и ID модели.

Шаг 4. Включить локальный сервер (только для движка Qwen3-VL)

• В LM Studio загрузите модель Qwen3-VL-8B-Instruct.
• Откройте вкладку Developer / Local Server и нажмите Start Server (по умолчанию http://localhost:1234).
• Убедитесь, что в настройках плагина qwenModelId совпадает с идентификатором загруженной модели.

Если включён только EasyOCR/Tesseract — сервер не нужен, движки работают напрямую.

Шаг 5. Использовать в чате

• В чате LM Studio приложите PDF или просто укажите путь к файлу.
• Напишите, например: «Обработай этот PDF и извлеки текст».
• Модель вызовет инструмент process_pdf, плагин прогонит файл через включённые движки и вернёт распознанный текст (если движков несколько — результаты будут помечены по движкам).

Параметры, которые модель может передать инструменту:

• file_path — путь к PDF (обязательно);
• pages — "1-5" или "2,4,7" (опц.);
• mode — ocr (чистый текст) или layout (таблицы в HTML, формулы в LaTeX).

Заметки и устранение проблем

• «Бэкенд завершился с кодом …» — обычно не установлены python-зависимости или неверный путь к Python в настройках. Проверьте pip list в том же интерпретаторе.
• EasyOCR + Qwen одновременно на 16 ГБ VRAM — может не хватить памяти. EasyOCR лёгкий, но при ошибке памяти снизьте DPI до 150 или оставьте один движок.
• Qwen3-VL не отвечает — проверьте, что сервер LM Studio запущен и модель загружена, а lmStudioServerUrl указывает на него.
• 30B/32B локально — на 16 ГБ не поместятся; для них используйте облачный сервер/эндпоинт и пропишите его URL и модель в настройках движка Qwen.
• Python поддержка плагинов LM Studio пока в разработке, поэтому сам плагин на TypeScript, а тяжёлый OCR вынесен в Python-бэкенд, который плагин запускает как подпроцесс.