LOOMA / ДОКУМЕНТАЦИЯ

Если что-то не получается

Поиск не находит документ#

Проверьте выбранные пространства и модель. Визуальные эмбеддинги привязаны к модели: переключение на другую модель не делает старые векторы совместимыми с ней. Проверьте её прогресс индексации. Для текстового поиска нужны сохранённый собственный текст PDF или OCR.

Первая операция занимает долгое время#

Скачивание весов, загрузка модели в память и первый запуск вычислений — разные этапы. Дождитесь завершения загрузки. Для удалённого режима проверьте журнал embed-сервера: он может ещё скачивать модели до открытия порта.

CUDA out of memory#

На GPU-сервере проверьте nvidia-smi, завершите ненужные процессы своим обычным способом и уменьшите EMBED_GPU_BATCH_SIZE до 1. Перезапуск embed-сервера освобождает удерживаемые им модели. Не запускайте несколько workers одного сервера на одной карте.

Ошибка mm_token_type_ids#

Обновите код embed-сервера вместе с зависимостями и перезапустите процесс. Клиентское обновление само по себе не обновляет удалённый сервер. Не исправляйте проблему случайным понижением Transformers: используйте согласованные зависимости из инструкции развёртывания.

Нет текста для копирования#

Для скана запустите OCR. Если обычный текст выделяется, а подпись на картинке нет, распознайте страницу через контекстное меню и включите OCR плашкой. Ошибки распознавания зависят от качества изображения и языка документа.

Не конвертируется Word или PowerPoint#

Конвертация через приложения Apple работает только на macOS. Установите Pages/Keynote, откройте исходный файл вручную и проверьте разрешения автоматизации в системных настройках. Если преобразование не подходит, экспортируйте PDF самостоятельно.

Заканчивается место#

Основной объём могут занимать веса моделей, эмбеддинги в базе, оригиналы, PLAID и временные задания сервера. Удаляйте ненужные модели штатными средствами приложения. Не удаляйте случайные строки SQLite или файлы работающего индекса. Очистка удалённых строк SQLite не всегда сразу уменьшает размер файла базы.

Как сообщить об ошибке#

Создайте issue: укажите ОС, версию приложения, модель, локальный или удалённый режим и шаги воспроизведения. Приложите фрагмент журнала без API-ключей и личных документов. Для embed-сервера полезны ответ /health и вывод nvidia-smi без лишних сведений о других задачах.