Komodo PDF: руководство от гика, что умеет open-source PDF-ридер с цитируемыми ответами ИИ

↓Скачать Komodo PDF

Komodo PDF — узкоспециализированный настольный PDF-ридер, в котором обычное чтение документа объединено с RAG-помощником: программа извлекает текст из открытого PDF, строит локальный индекс и возвращает ответы со ссылками на страницы и подсветкой исходных фрагментов. Это важно отличать от полноценного PDF-редактора: в версии 0.1.1 нет инструментов изменения текста и изображений, OCR, подписания, аннотирования, конвертации и экспорта изменённого PDF. Продукт рассчитан прежде всего на чтение длинных текстовых документов и проверяемую работу с их содержанием.

Проект распространяется бесплатно с открытым исходным кодом по GPLv3. Готовые сборки выпускаются для Windows 10/11 x64 в виде EXE, MSI и portable ZIP; macOS и Linux поддерживаются на уровне самостоятельной сборки из исходников. Команда проекта не содержит собственного облачного сервера: чтение, извлечение текста, локальное индексирование и локальные embeddings выполняются на компьютере, а обращения к внешней модели идут только к тому OpenAI-compatible endpoint, который указал пользователь. При полностью локальном chat endpoint документ можно обрабатывать без передачи его содержания в сеть.

Что такое Komodo PDF и с каким продуктом его не нужно путать

Официальное название проекта — Komodo PDF. Публичный репозиторий находится в аккаунте GitHub awirayaksa, а сам проект описан как молодой open-source продукт одного разработчика. Название не относится к Komodo Platform, криптовалютным инструментам, CAN-интерфейсам или другим решениям со словом Komodo. Здесь речь только о локальном PDF-ридере на Tauri 2, React и pdf.js.

Назначение Komodo PDF проще, чем у Adobe Acrobat Pro, Foxit PDF Editor или других редакторов: открыть PDF, прочитать его с непрерывной прокруткой, перейти по структуре документа, выделить текст и задать вопрос по содержанию. Для задач изменения PDF разумнее сразу смотреть отдельный материал GeekHow о бесплатных программах для редактирования PDF, потому что Komodo PDF сознательно не пытается быть заменой Acrobat.

Параметр	Komodo PDF 0.1.1
Тип	Настольный PDF-ридер с локальным индексом и RAG-панелью
Разработчик	Open-source проект аккаунта awirayaksa на GitHub
Актуальная публичная версия	0.1.1
Готовые сборки	Windows 10/11 x64: EXE, MSI, portable ZIP
macOS и Linux	Самостоятельная сборка из исходников; готовых бинарных пакетов версии 0.1.1 нет
Основной формат	PDF
Движок PDF	pdf.js
ИИ-архитектура	RAG: извлечение текста, разбиение на фрагменты, embeddings, SQLite-векторное хранилище, retrieval, ответ chat-модели
Embeddings	Локальные ONNX-модели или удалённый OpenAI-compatible endpoint
Chat-модель	OpenAI-compatible endpoint, в том числе локальный сервер
Регистрация Komodo	Не требуется; собственного Komodo backend нет
Лицензия и цена	GPLv3, сама программа бесплатна; расходы внешнего AI-провайдера зависят от выбранного сервиса
Интерфейс	Английский
Редактирование, OCR, подпись	Не входят в текущий функционал

Текущий статус, платформы и распространение

Версия 0.1.1 опубликована как актуальный релиз 30 мая 2026 года. Для Windows доступны рекомендованный установщик EXE, MSI-пакет для администрируемого развёртывания и portable ZIP без установки. На странице проекта указаны размеры около 9,3 МБ для EXE, 13,1 МБ для MSI и 12,9 МБ для portable-архива. Это размеры оболочки приложения; локальные embedding-модели загружаются отдельно и занимают дополнительное место.

Для macOS и Linux готовых релизных бинарников нет. Сборка основана на Tauri, а исходный README требует Node.js 18+, стабильный Rust toolchain и системные зависимости Tauri для конкретной платформы. Поэтому формулировка «поддерживает macOS и Linux» здесь означает, что программу можно собрать из исходников, а не получить готовый установщик для обычного пользователя.

Windows-сборка версии 0.1.1 не подписана сертификатом издателя. Из-за этого SmartScreen способен показать предупреждение Unknown publisher. Проект отдельно рекомендует сверять SHA-256 релизного файла. Для продукта, который позиционируется как приватный локальный ридер, отсутствие code signing — существенное ограничение зрелости, а не косметическая деталь.

Komodo PDF не требует учётной записи на собственном сервере, потому что такого сервера у проекта нет. Для удалённой chat-модели понадобится собственный доступ к выбранному OpenAI-compatible провайдеру. При локальном chat endpoint это внешнее условие исчезает после того, как нужные локальные компоненты уже установлены.

Интерфейс: четыре рабочие зоны без редакторской ленты

Окно построено вокруг четырёх зон: верхней панели, боковой структуры документа, центрального ридера и правой панели Ask Komodo. Такое деление соответствует назначению продукта: слева навигация, в центре первоисточник, справа диалог и ссылки на доказательства. Перетаскиваемый разделитель меняет ширину центральной области и AI-панели.

Верхняя панель

На панели находятся название Komodo PDF, кнопка показа или скрытия Outline и команда Open PDF. После открытия документа появляются номер текущей страницы и общее количество страниц, кнопки перехода назад и вперёд, увеличение и уменьшение масштаба, а также режимы Fit width и Fit page. Отдельной ленты Edit, Comment, Sign или Convert нет.

Outline

Левая панель читает встроенную структуру PDF. Вложенные пункты можно раскрывать, а переход по пункту меняет текущую страницу. Если в документе нет outline/bookmarks, панель прямо показывает No outline available. Это не ошибка импорта: структура берётся из самого PDF, а Komodo не создаёт её автоматически.

Reader

Центральная часть рисует страницы через pdf.js и поверх canvas строит настоящий текстовый слой. Благодаря этому текст можно выделять, а не только смотреть как изображение. Страницы идут непрерывной вертикальной лентой; видимые страницы отрисовываются по мере попадания в область просмотра. Если у страницы нет текстового слоя, снизу появляется метка No text layer — AI unavailable here.

Ask Komodo

Правая панель содержит историю сообщений, поле Ask anything…, кнопку Send, индикатор состояния индекса и Settings. Ответы выводятся как форматированный Markdown-текст. После ответа под ним появляются компактные кнопки p.N; нажатие переводит ридер на исходную страницу и временно подсвечивает координаты найденного фрагмента.

Settings

Окно Settings разделено на Chat (required), Embeddings и Advanced. Для chat указываются Base URL, API Key и Model. Для embeddings выбирается Local (recommended) или Remote. В расширенной части доступны Top-K retrieval от 1 до 20, Persona с вариантами Explain simply, Cite sources strictly и Summarize, а также уровень логирования от error до trace.

Основные функции и ограничения

Чтение PDF и навигация

Komodo открывает один PDF через системный диалог выбора файла. В фильтре Open PDF разрешено расширение pdf. Ридер поддерживает непрерывную прокрутку, изменение масштаба, Fit width, Fit page, переход по номеру страницы и встроенный outline. Это базовый слой продукта, который работает независимо от AI-конфигурации.

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

Настоящий текстовый слой

Поверх изображения страницы создаётся текстовый слой pdf.js. Выделенный пользователем текст сохраняется в состоянии ридера и может стать приоритетным контекстом для следующего вопроса. Это отличает сценарий «объясни выбранный абзац» от общего поиска по всему документу: выбор уже указывает системе, на какой участок обратить внимание.

Сканированная страница без текстового слоя остаётся доступной для визуального чтения, но встроенный AI не получает из неё текст. В версии 0.1.1 нет OCR-модуля, поэтому для бумажных архивов сначала понадобится отдельное распознавание. При подготовке исходников полезен и обзор GeekHow о сканерах для оцифровки документов, особенно когда качество текста зависит от исходного скана.

Локальное индексирование и RAG

При первом обращении к содержанию PDF Komodo извлекает текст и координаты по страницам, затем делит текст на перекрывающиеся фрагменты примерно по 700 токенов с учётом границ предложений. Для каждого фрагмента рассчитывается embedding, после чего данные записываются в локальное SQLite-векторное хранилище. Индекс привязан к SHA-256 хешу файла, поэтому повторное открытие того же байтового файла позволяет использовать уже построенный индекс.

Для каждого вопроса embedding вопроса сравнивается с векторами сохранённых фрагментов по cosine similarity. В контекст ответа входят лучшие совпадения, текущая страница и выделение. Настройка Top-K определяет, сколько найденных фрагментов участвует в retrieval; значение по умолчанию в интерфейсе равно 6, разрешённый диапазон — от 1 до 20.

Локальные embeddings

В реестре 0.1.1 доступны bge-small-en-v1.5, multilingual-e5-small, bge-base-en-v1.5, nomic-embed-text-v1.5 в quantized-варианте и nomic-embed-text-v1.5-f32. Модели различаются размерностью 384 или 768 и объёмом файла модели. Ресурсы скачиваются отдельно в каталог models; статус Resources ready означает, что необходимые файлы присутствуют.

Для русскоязычных и других неанглийских документов практический интерес представляет multilingual-e5-small, потому что он помечен в реестре как CJK/multilingual. Выбор другого embedding-моделя меняет векторное представление, поэтому уже существующий индекс необходимо перестроить через Reindex.

Удалённые embeddings

В режиме Remote для embeddings вводятся Base URL, API Key и Model ID. Это отдельная конфигурация от chat-модели. Текстовые фрагменты, которые требуется векторизовать, в таком режиме обрабатываются указанным embedding endpoint, поэтому режим нельзя считать полностью локальным.

Chat через OpenAI-compatible endpoint

Komodo не привязан к одной конкретной компании-модели: настройки принимают Base URL, Model и API Key для OpenAI-compatible интерфейса. В документации в качестве стандартного URL приведён OpenAI API, но архитектура допускает совместимые облачные шлюзы и локальные серверы. Сам Komodo не выступает посредником и не хранит пользовательские обращения на своём backend.

Ответы с источниками и проверкой

AI-панель получает потоковый ответ и отдельно список найденных источников. Ссылки вида [n] преобразуются в кнопки страниц. После нажатия Reader переходит к странице и подсвечивает прямоугольники исходного фрагмента примерно на три секунды. Это не гарантирует истинность выводов модели, но делает проверку заметно конкретнее: читатель видит, на какой текст опирался ответ.

Внутренняя логика содержит confidence routing: при сильном совпадении с документом ответ остаётся привязанным к нему, а при недостатке материала помощник может перейти к общим знаниям и обозначить это. Для строгого чтения полезнее Persona Cite sources strictly, потому что сама формулировка режима задаёт более жёсткое отношение к ссылкам.

Контекст текущей страницы, выделения и диалога

Текущая страница и выделенный текст получают повышенный приоритет. Кроме того, в каждое новое обращение передаётся недавняя история — до шести предыдущих сообщений. Поэтому короткое уточнение после первого ответа не начинается полностью с нуля, но длинная беседа не хранится в бесконечном окне контекста.

Что Komodo PDF не делает

Текущая версия не редактирует текст и изображения в PDF, не добавляет комментарии, подписи, формы и штампы, не выполняет OCR, не объединяет и не разделяет страницы, не конвертирует Office-файлы и не создаёт новый PDF. Для преобразования текста в редактируемый документ можно использовать отдельную инструкцию GeekHow по конвертации PDF в Google Docs, а обратный маршрут описан в материале о конвертации Google Docs в PDF.

Что происходит с документом от открытия до ответа

Рабочая цепочка разделена на локальную подготовку и этап генерации. Сначала pdf.js открывает документ и извлекает текст по страницам. Далее Rust-часть делит материал на перекрывающиеся фрагменты, рассчитывает embeddings и сохраняет векторы в SQLite. При вопросе формируется embedding вопроса, выбираются ближайшие фрагменты, добавляются текущая страница и выделение, после чего подготовленный контекст отправляется chat-модели.

При локальных embeddings и локальном chat endpoint весь путь остаётся на устройстве. При удалённой chat-модели retrieved-фрагменты уходят указанному провайдеру. При удалённых embeddings текст для построения векторов также обрабатывается внешним embedding endpoint. Поэтому приватность определяется не только названием программы, но и конкретной комбинацией Local/Remote в Settings.

Результат Komodo PDF — не новый файл, а состояние чтения: открытый PDF, локальный индекс и ответ в правой панели с переходами к страницам. Это принципиально для ожиданий пользователя. Если задача заканчивается исправленным PDF, подписанным документом или экспортом в DOCX, нужен другой класс программ.

Задача → инструмент → результат → что проверить

Задача	Инструмент Komodo	Результат	Что проверить
Прочитать длинный PDF	Continuous scroll, Fit width/Fit page, масштаб	Последовательное чтение страниц	Правильный номер страницы и удобный масштаб
Перейти к главе	Outline	Переход к destination из структуры PDF	Совпадает ли заголовок с открытой страницей
Разобрать конкретный абзац	Текстовый слой + Ask about this selection	Вопрос с приоритетом выделенного текста	Выделен ли именно нужный фрагмент
Найти ответ по всему документу	RAG retrieval + Ask Komodo	Ответ с ссылками p.N	Открыть каждую существенную ссылку и сопоставить с формулировкой ответа
Работать с русским PDF локально	multilingual-e5-small + совместимый chat endpoint	Многоязычный локальный индекс	После смены модели перестроен ли индекс
Избежать передачи текста облаку	Local embeddings + локальный OpenAI-compatible chat endpoint	Локальная обработка после загрузки моделей	В Settings не выбран Remote и Base URL chat указывает на локальный endpoint
Проверить происхождение ответа	Кнопки p.N и подсветка source quads	Переход к исходному месту PDF	Действительно ли фрагмент подтверждает вывод, а не только содержит похожие слова

Карта форматов и совместимости

Объект	Поддержка	Редактируемость	Потери и ограничения	Переносимость
PDF с текстовым слоем	Основной входной формат	Только чтение и выделение	Содержимое PDF не меняется	Исходный PDF остаётся обычным PDF
Сканированный PDF без текстового слоя	Визуально открывается	Текст для AI недоступен	OCR отсутствует; страница помечается No text layer	Исходный файл не преобразуется
DOCX, XLSX, PPTX, изображения как отдельные файлы	Не являются входными форматами Open PDF	Нет	Конвертация не входит в 0.1.1	Нужен внешний конвертер перед открытием
AI-ответ	Отображается в Ask Komodo	Это текст диалога, а не слой PDF	Команды экспорта ответа в отдельный документ в текущем UI нет	Не является частью исходного PDF
Локальный индекс	SQLite-векторное хранилище	Перестраивается через Reindex	Зависит от выбранной embedding-модели	Привязан к хешу файла и локальным данным приложения

Приватность, безопасность и зависимость от интернета

Главное архитектурное отличие Komodo PDF — отсутствие Komodo backend. Проект не содержит собственного сервера для загрузки документов, не включает телеметрию и analytics SDK в приложении и прямо исключает добавление phone-home механики из своего направления разработки. Сам сайт использует cookieless Cloudflare analytics, но это относится к веб-странице, а не к настольному ридеру.

API Key для chat и отдельный API Key для remote embeddings сохраняются через системное хранилище секретов с зашифрованным fallback на диске. Это лучше, чем хранение в открытом конфигурационном файле, но пользователь всё равно отвечает за выбранного внешнего провайдера и его правила обработки данных.

При удалённой chat-модели Komodo отправляет не весь PDF как файл, а контекст из retrieved-фрагментов, текущей страницы и выделения. Эти фрагменты уже являются содержанием документа, поэтому конфиденциальный PDF нельзя считать полностью локальным только потому, что исходный файл не загружался целиком. Для строгого режима нужны Local embeddings и локальный chat endpoint.

Локальные ONNX-модели embeddings загружаются по HTTPS из публичных репозиториев моделей. После появления статуса Resources ready их вычисление выполняется на устройстве. Первый download требует сети, но последующее чтение и локальное индексирование не требуют соединения с Komodo.

Для удалённого AI сеть остаётся рабочей зависимостью. Если локальное подключение к интернету нестабильно, общие методы проверки собраны в инструкции GeekHow о ситуации, когда на компьютере нет подключения к интернету; внутри Komodo дополнительно следует смотреть результат Test connection отдельно для Chat и Embeddings.

Что перестанет работать первым при отключении зависимостей

Без интернета при удалённой chat-модели. Чтение PDF, Outline, масштаб, выделение и уже имеющийся локальный индекс останутся доступны, но новый ответ получить нельзя, потому что endpoint недоступен.

Без интернета при Local embeddings, но удалённом chat. Индекс можно строить локально, если модель уже скачана, однако финальный ответ всё равно зависит от chat endpoint.

Без интернета при полностью локальной схеме. После загрузки embedding-модели и подготовки локального OpenAI-compatible chat сервера сеть не нужна для текста документа. Это самый независимый режим, но локальный chat сервер должен быть запущен и доступен по указанному Base URL.

При недоступном embedding endpoint в режиме Remote. Новый документ нельзя полноценно индексировать, поэтому RAG-ответы по нему не будут готовы. Уже созданный индекс для совместимой конфигурации остаётся локальным, но смена embedding-модели потребует перестроения.

При повреждении или перемещении локальных model resources. Settings перестанет показывать Resources ready для выбранной ONNX-модели. PDF по-прежнему читается, но локальное индексирование этой моделью требует восстановить её файлы.

При отключении внешней учётной записи AI-провайдера. Komodo как ридер продолжит работать. Ограничение затронет только тот удалённый endpoint, который связан с этой учётной записью. Собственного аккаунта Komodo, способного заблокировать локальное чтение, нет.

Жизненный цикл и зрелость продукта

Komodo PDF находится на ранней стадии. Текущий релиз 0.1.1, опубликованный 30 мая 2026 года, прямо назван молодым one-person проектом. Готовый пакет ориентирован на Windows x64, а macOS и Linux пока требуют самостоятельной сборки. Windows-бинарники не подписаны сертификатом издателя. Эти признаки важнее номера версии: продукт уже имеет законченный базовый сценарий чтения и RAG, но ещё не обладает инфраструктурой зрелого массового PDF-комбайна.

Сфера проекта намеренно ограничена. README формулирует Komodo как reader with a grounded AI panel, not an Acrobat clone. Поэтому отсутствие OCR, редактирования страниц, форм, электронной подписи и конвертации — не пропущенные пункты тарифной сетки, а текущая граница продукта. При выборе следует исходить из этой границы, а не ожидать, что привычные функции PDF-редактора просто скрыты в другом меню.

Open-source модель снижает риск полного исчезновения кода: репозиторий и GPLv3 позволяют изучать и собирать приложение независимо от сайта. Но она не создаёт гарантию долгосрочной поддержки, корпоративного SLA или совместимости будущих версий Windows. Для организаций это означает необходимость собственных процедур проверки сборок и обновлений.

Цена, лицензирование и реальные расходы

Komodo PDF бесплатен и лицензирован по GNU GPLv3. У продукта нет отдельной Pro-редакции, пробного периода, платной разблокировки OCR или подписки на собственный AI, потому что собственного AI-сервиса Komodo не продаёт.

Расходы появляются за пределами программы. Удалённая chat-модель или remote embeddings могут тарифицироваться выбранным провайдером; условия зависят от этого сервиса и не являются ценой Komodo. В полностью локальной конфигурации прямой платёж Komodo отсутствует, но компьютер предоставляет вычислительные ресурсы и дисковое место для локальных моделей.

Для организации полезно учитывать не только нулевую цену лицензии, но и эксплуатационный профиль: неподписанная Windows-сборка, ранняя версия, отсутствие готовых macOS/Linux пакетов и необходимость самостоятельно выбирать AI-инфраструктуру. Для массового управляемого развёртывания дополнительно потребуются внутренние проверки дистрибутива, AI-инфраструктуры и политики обновлений.

Как пользоваться программой — советы гика

Настроить chat endpoint и embeddings

Цель: подготовить Ask Komodo к работе. Подготовка: нужен OpenAI-compatible chat endpoint; для облачного сервиса также нужен API Key, для локального сервера — его Base URL и точное имя модели. Нажмите кнопку с шестерёнкой в заголовке Ask Komodo. В блоке Chat (required) заполните Base URL, API Key и Model. В Embeddings выберите Local (recommended), если векторы должны считаться на компьютере, или Remote, если используется внешний embedding endpoint. Для Remote дополнительно задайте Base URL, API Key и Model ID. Нажмите Test connection: ниже должны появиться отдельные результаты Chat ✓ и Embeddings ✓. Затем нажмите Save.

Проверка: внизу Ask Komodo вместо Not configured отображается состояние, связанное с индексом. Типичная ошибка: неверный Base URL, имя модели или API Key приводит к Chat ✗ либо Embeddings ✗. Безопасный откат: если поля изменены, но Test connection и Save ещё не нажимались, Cancel закрывает окно без сохранения полей. После Test connection кандидатные настройки уже записываются для проверки, поэтому возврат к старой конфигурации выполняется повторным вводом прежних значений и Save.

Скачать локальную embedding-модель

Цель: сделать индексирование независимым от внешнего embedding API. Подготовка: в Settings должен быть выбран Embeddings → Local (recommended), а на первом download нужен интернет. Выберите Model из списка. Если под моделью отображается Not downloaded, нажмите Download. Дождитесь завершения окна загрузки; после повторного чтения статуса строка меняется на Resources ready. Команда Open models folder открывает каталог ресурсов выбранной модели.

Параметры: для английского текста доступна bge-small-en-v1.5; для многоязычного текста — multilingual-e5-small; в реестре также есть bge-base-en-v1.5 и два варианта nomic-embed-text-v1.5. Проверка: Settings показывает Resources ready. Типичная ошибка: download прерывается сетью и статус остаётся Not downloaded. Безопасный откат: не запускайте индексирование с незавершёнными ресурсами; повторите Download для той же модели либо выберите уже загруженную модель.

Открыть PDF

Цель: загрузить исходный документ без его изменения. Подготовка: файл должен иметь формат PDF. Нажмите Open PDF на верхней панели. В системном диалоге выберите один файл с расширением .pdf. После загрузки программа вычислит SHA-256, прочитает количество страниц и outline. В центральной области появятся страницы, а на верхней панели — индикатор вида 1 / N.

Проверка: первая страница видна в Reader, а число N соответствует документу. Типичная ошибка: DOCX, изображение или другой формат не появляется как подходящий файл, потому что диалог фильтрует PDF. Безопасный откат: открытие не переписывает исходник; чтобы сменить документ, снова используйте Open PDF и выберите другой файл.

Навигировать по страницам, Outline и масштабу

Цель: быстро перейти к нужному месту и подобрать масштаб. Подготовка: PDF уже открыт. Для последовательного перехода используйте кнопки ‹ и › рядом с текущим номером страницы. Для структуры нажмите ☰ и выберите пункт в Outline; треугольник раскрывает вложенные пункты. Для масштаба используйте + и −. Кнопка с подсказкой Fit width подгоняет страницу по ширине, а Fit page — целую страницу по области просмотра. Повторное нажатие активного режима Fit отключает его.

Проверка: индикатор текущей страницы меняется вместе с прокруткой и переходами. Типичная ошибка: Outline показывает No outline available — это означает отсутствие встроенной структуры в PDF, а не повреждение ридера. Безопасный откат: масштаб не изменяет файл; для возврата из Fit нажмите активную кнопку ещё раз и установите удобный процент через +/−.

Выделить текст и задать вопрос по фрагменту

Цель: дать AI узкий контекст вместо поиска по всему документу. Подготовка: на странице должен существовать текстовый слой. Выделите мышью нужный абзац в Reader. Под панелью сообщений появится кнопка Ask about this selection. Нажмите её: Komodo сформирует вопрос Explain this с началом выделенного текста и отправит его в обычный RAG-процесс. Текущая страница и выделение дополнительно включаются в приоритетный контекст.

Проверка: в истории появляется сообщение от You, затем ответ Komodo. Типичная ошибка: на скане выделение не работает, а на странице видна метка No text layer — AI unavailable here. Безопасный откат: ничего в PDF не меняется; снимите выделение щелчком в другом месте и задайте обычный вопрос через Ask anything… либо предварительно распознайте скан во внешнем OCR-инструменте.

Проиндексировать документ для RAG

Цель: построить локальный поиск по смысловым фрагментам PDF. Подготовка: chat и embeddings настроены, а для Local модель имеет статус Resources ready. Введите вопрос в Ask anything… и нажмите Send либо Enter. Если индекс отсутствует, откроется окно Index for AI. Нажмите Index now. В окне Indexing… отображается счётчик обработанных страниц. После завершения состояние меняется на Ready to answer, а отложенный первый вопрос отправляется автоматически.

Проверка: внизу Ask Komodo появляется Ready to answer. Типичная ошибка: Local model не загружена или remote embedding endpoint не проходит проверку. Безопасный откат: до Index now используйте Cancel. Если индекс построен с неподходящей embedding-моделью, исправьте Settings и примените Reindex; исходный PDF при этом не затрагивается.

Задать вопрос и проверить цитаты

Цель: получить ответ, который можно сопоставить с текстом PDF. Подготовка: состояние индекса — Ready to answer. Введите конкретный вопрос в Ask anything… и нажмите Send; Enter отправляет сообщение, Shift+Enter оставляет перевод строки. Во время генерации отображается Thinking…. После завершения под ответом появляются кнопки p.N для использованных источников. Нажмите каждую существенную кнопку: Reader перейдёт к странице и подсветит координаты фрагмента.

Проверка: формулировка на подсвеченной странице действительно подтверждает соответствующую часть ответа. Типичная ошибка: ответ опирается на общие знания, когда документ недостаточно отвечает на вопрос; confidence routing должен обозначить этот режим. Безопасный откат: не переносите неподтверждённый вывод в рабочий документ; переформулируйте вопрос так, чтобы он требовал факты из PDF, либо включите Persona Cite sources strictly.

Изменить Persona и Top-K

Цель: скорректировать стиль ответа и ширину retrieval. Подготовка: Settings доступен через шестерёнку. Откройте Advanced. В Top-K retrieval задайте число от 1 до 20; меньшие значения уменьшают количество retrieved-фрагментов, большие дают модели более широкий набор кандидатов. В Persona выберите Explain simply, Cite sources strictly или Summarize. Нажмите Save.

Проверка: новые вопросы используют выбранную Persona и значение Top-K. Типичная ошибка: попытка решить сменой Persona проблему отсутствующего текста на скане — Persona не создаёт текстовый слой. Безопасный откат: верните Top-K к 6 и Persona к Explain simply, затем Save. Изменение этих параметров не переписывает PDF.

Сменить embedding-модель и выполнить Reindex

Цель: перестроить смысловой индекс под другую модель, например multilingual-e5-small. Подготовка: новая локальная модель должна иметь Resources ready либо remote embeddings должны проходить Test connection. В Settings выберите новую модель и нажмите Save. Вернитесь в Ask Komodo. Если документ имеет готовый индекс, нажмите Reindex в строке состояния. Подтвердите Reindex this document? — программа удалит существующий индекс этого файла и откроет Indexing… для построения нового.

Проверка: после завершения снова отображается Ready to answer, а новые вопросы используют текущую embedding-конфигурацию. Типичная ошибка: поменять модель и продолжить использовать старый индекс. Безопасный откат: если новая модель даёт нежелательный результат, верните прежнюю модель в Settings и ещё раз выполните Reindex. Исходный PDF остаётся неизменным; меняется только локальный векторный индекс.

Сквозной сценарий: от запуска до проверенного ответа

Цель: получить проверяемое резюме раздела без изменения исходного файла. Подготовка: Windows 10/11 x64, Komodo PDF 0.1.1, PDF с текстовым слоем и настроенный chat endpoint. Сначала откройте Settings, настройте Chat и выберите Local embeddings. Если модель не готова, скачайте её до Resources ready, затем выполните Test connection и Save. Нажмите Open PDF и выберите документ. Через Outline перейдите к нужной главе или оставьте ридер на первой странице. Введите в Ask anything… вопрос о главных выводах нужного раздела и нажмите Send. При появлении Index for AI выберите Index now и дождитесь Ready to answer. После ответа последовательно откройте p.N, сопоставьте формулировки с подсвеченным текстом и только после этого используйте выводы вне Komodo.

Проверка результата: каждая существенная часть итогового ответа имеет подтверждение в открываемых источниках либо явно отделена как общая информация модели. Типичная ошибка: ожидать появления нового PDF после работы — Komodo не редактирует и не экспортирует документ. Безопасный откат: исходный файл не изменяется; при ошибочной AI-конфигурации исправьте Settings и Reindex, а при неверном документе просто откройте другой PDF.

Плюсы и минусы

Плюсы

• PDF остаётся локальным файлом; у Komodo нет собственного backend для загрузки документов.
• Обычное чтение не зависит от AI: continuous scroll, zoom, Fit width/Fit page, Outline и выделение работают отдельно.
• RAG-ответы снабжаются ссылками на страницы, которые переводят к исходному фрагменту и подсвечивают его.
• Локальные embeddings работают через ONNX, а для chat можно указать локальный OpenAI-compatible endpoint и получить полностью локальную схему.
• Отдельные настройки remote embeddings и chat позволяют не привязываться к одному поставщику моделей.
• Индекс сохраняется локально в SQLite и привязывается к хешу PDF, поэтому повторное открытие того же файла не требует полного перестроения.
• GPLv3 и открытый репозиторий позволяют изучить реализацию и собрать приложение самостоятельно.
• Есть EXE, MSI и portable ZIP для Windows x64, что покрывает установку, администрируемое развёртывание и запуск без инсталляции.

Минусы

• Версия 0.1.1 остаётся ранним one-person проектом без подписанного Windows-бинарника.
• Готовых сборок для macOS и Linux нет; требуется Node.js, Rust и окружение Tauri для самостоятельной сборки.
• Нет редактирования PDF, аннотаций, форм, электронной подписи, конвертации и экспорта изменённого документа.
• Нет OCR: страницы без текстового слоя можно читать визуально, но AI на них недоступен.
• Интерфейс текущей версии англоязычный.
• Удалённая chat-модель получает retrieved-фрагменты документа; remote embeddings также требуют передачи текста внешнему endpoint.
• Стоимость удалённого AI не включена в продукт и зависит от стороннего провайдера.
• Нет зрелой экосистемы корпоративной поддержки, характерной для крупных PDF-платформ.

Кому подойдёт

• Пользователю Windows, который читает длинные технические, учебные или рабочие PDF и хочет переходить от AI-ответа непосредственно к странице-источнику.
• Разработчику или техническому специалисту, которому нужен open-source PDF/RAG клиент с подключением собственного OpenAI-compatible endpoint.
• Пользователю, для которого важен локальный индекс и отсутствие обязательной загрузки целого PDF на сервер отдельного «chat with PDF» сервиса.
• Читателю многоязычных документов, готовому выбрать multilingual embedding-модель и самостоятельно оценивать качество retrieval по ссылкам на страницы.
• Организации, которая способна самостоятельно проверить исходный код, пакеты и модель развёртывания и которой достаточно сценария чтения без редактирования.

Кому не подойдёт

• Тем, кому нужен полноценный PDF-редактор: изменение текста и изображений, перестановка страниц, формы, подпись, комментарии и redaction отсутствуют.
• Тем, кто регулярно работает со сканами без текстового слоя и рассчитывает на встроенный OCR.
• Пользователям macOS и Linux, которым нужен готовый официальный установщик без сборки из исходников.
• Компаниям, где политика разрешает только подписанные binaries от коммерческого поставщика с формальным SLA.
• Тем, кто хочет встроенный облачный AI без собственной настройки Base URL, Model и API Key.
• Тем, кто ожидает мобильное приложение или синхронизацию документов между устройствами.

Сравнение с другими аналогами

Komodo PDF логичнее сравнивать не только с PDF-редакторами, но и с ридерами, потому что его главный сценарий — чтение плюс AI. Ниже одинаковые критерии применены к четырём альтернативам.

Продукт	Главная задача	Платформы	Порог освоения	Форматы	Автоматизация и AI	Модель оплаты	Главное ограничение	Когда выбирать
Adobe Acrobat Reader / Acrobat Pro	Чтение, комментарии, формы; в Pro — редактирование и полный PDF-workflow	Windows, macOS, iOS, Android, web	Низкий для Reader, средний для Pro	PDF; в платных редакциях создание и конвертация других форматов	AI Assistant с цитируемыми ответами и расширенные облачные рабочие процессы	Reader бесплатен; Pro и расширенные AI-сценарии платные	Полный набор функций связан с коммерческими планами и облачной экосистемой	Когда нужны формы, комментарии, подписи, редактирование, OCR или стандартизированная корпоративная платформа
Foxit PDF Reader / PDF Editor	Чтение и аннотации; в Editor — редактирование, конвертация, OCR	Windows, macOS, iOS, Android, web	Низкий для Reader, средний для Editor	PDF и конвертация в редакторе	PDF AI Assistant; у актуальной линейки есть cloud и Local AI, Workspace для нескольких документов	Reader бесплатен; Editor и расширенный AI — коммерческие планы, есть trial	Функциональность распределена между Reader, Editor и AI-сервисами	Когда нужен более зрелый PDF-клиент с аннотациями и переходом при необходимости к полноценному редактору
PDFgear	Бесплатное редактирование, конвертация, OCR, организация страниц и AI	Windows, macOS, iOS, Android, web	Низкий или средний	PDF и широкий набор конвертаций Office/изображений	AI assistant/Copilot и пакетные операции в ряде задач	Текущая настольная линейка заявлена как бесплатная	Это другой класс продукта: больше функций редактирования, но не open-source local-first RAG-клиент	Когда после чтения нужно реально изменить, конвертировать, распознать или собрать PDF
SumatraPDF	Быстрое локальное чтение документов	Windows	Низкий	PDF, EPUB, MOBI, CBZ, CBR, FB2, CHM, XPS, DjVu	Есть командная строка и настройки, встроенного document AI нет	Бесплатный open-source	Нет встроенного RAG-помощника и полноценного PDF-редактирования	Когда главнее минималистичное офлайн-чтение множества форматов, а AI не нужен

Если приоритет — проверяемый AI поверх одного локального PDF и собственный endpoint, Komodo занимает отдельную нишу. Если приоритет смещается к редактированию, OCR, формам или конвертации, Acrobat, Foxit или PDFgear закрывают больше операций. Если AI вообще не нужен, SumatraPDF проще и поддерживает больше форматов чтения.

Типичные проблемы и диагностика

SmartScreen показывает Unknown publisher

Симптом: Windows предупреждает о неизвестном издателе при запуске установщика. Причина: релиз 0.1.1 не имеет code signing. Диагностика: имя файла и версия должны соответствовать официальному релизу, а SHA-256 — опубликованному checksum. Исправление: используйте только официальный релиз и продолжайте запуск только после проверки файла по политике безопасности вашей системы. Проверка: установленное приложение показывает Komodo PDF и версию 0.1.1, а скачанный пакет совпадает по контрольной сумме.

В Open PDF не виден нужный файл

Симптом: документ DOCX, изображение или другой тип нельзя выбрать. Причина: системный диалог Komodo фильтрует расширение pdf. Диагностика: проверьте фактическое расширение исходника. Исправление: предварительно преобразуйте документ в PDF внешним инструментом. Проверка: после появления файла .pdf он доступен в Open PDF и открывается в Reader.

Outline пишет No outline available

Симптом: левая панель пустая, хотя PDF читается. Причина: в исходном PDF нет встроенного outline/bookmarks. Диагностика: страницы и текст отображаются нормально, а сообщение находится только в Outline. Исправление: используйте прокрутку и переходы по страницам; Komodo не генерирует структуру автоматически. Проверка: навигация по страницам работает независимо от Outline.

На странице показано No text layer — AI unavailable here

Симптом: страницу видно, но текст не выделяется и AI не может опереться на неё. Причина: PDF содержит скан-изображение без текстового слоя. Диагностика: нижняя метка прямо сообщает отсутствие text layer. Исправление: выполните OCR во внешнем приложении и откройте версию PDF с распознанным текстом. Проверка: на новой версии текст выделяется, а метка больше не появляется на распознанной странице.

Поле Ask anything… недоступно

Симптом: поле вопроса отключено или показывает Configure API key to ask…. Причина: chat-конфигурация не сохранена либо PDF ещё не открыт. Диагностика: внизу панели видна строка Not configured — open Settings (⚙) to add your API key либо отсутствует fileName. Исправление: настройте Chat в Settings, проверьте Test connection и откройте PDF. Проверка: поле становится активным и принимает текст.

Локальная embedding-модель имеет статус Not downloaded

Симптом: Settings не показывает Resources ready. Причина: файлы выбранной ONNX-модели ещё не скачаны полностью. Диагностика: рядом доступна кнопка Download и указан приблизительный объём. Исправление: завершите Download при стабильном соединении. Проверка: статус меняется на Resources ready, а модель появляется в локальном каталоге.

Test connection показывает Chat ✗ или Embeddings ✗

Симптом: проверка соединения возвращает ошибку в одном из двух каналов. Причина: соответствующий Base URL, Model, Model ID или API Key не принимается endpoint. Диагностика: смотрите отдельно строку Chat и строку Embeddings — они тестируются раздельно. Исправление: исправьте параметры только проблемного endpoint и повторите Test connection. Проверка: обе необходимые строки показывают ✓.

Первый вопрос не отправляется сразу, а открывает Index for AI

Симптом: после Send появляется окно индексирования вместо ответа. Причина: для хеша этого PDF ещё нет готового индекса с текущей embedding-конфигурацией. Диагностика: состояние внизу Ask Komodo было Not indexed — first ask will index this document. Исправление: подтвердите Index now и дождитесь завершения. Проверка: состояние становится Ready to answer, а первоначальный вопрос отправляется автоматически.

После смены embedding-модели ответы используют старый индекс

Симптом: модель в Settings изменена, но документ уже имел готовый индекс. Причина: старые векторы были рассчитаны прежней моделью. Диагностика: Settings предупреждает, что смена embedding model requires re-indexing, а в Ask Komodo доступна ссылка Reindex. Исправление: нажмите Reindex, подтвердите удаление старого индекса и дождитесь нового. Проверка: после Indexing… снова появляется Ready to answer.

AI перестал отвечать без интернета

Симптом: PDF читается, но новый ответ не появляется или приходит ошибка. Причина: chat Base URL или remote embeddings указывают на сетевой endpoint. Диагностика: локальные функции чтения работают, а Test connection не проходит. Исправление: восстановите сеть либо переключитесь на заранее подготовленный локальный OpenAI-compatible chat endpoint и Local embeddings. Проверка: Test connection снова проходит, после чего Send возвращает ответ.

На macOS или Linux нет готового установщика

Симптом: на странице релиза доступны только Windows EXE/MSI/ZIP. Причина: для 0.1.1 prebuilt macOS/Linux binaries не выпущены. Диагностика: README описывает эти платформы через самостоятельную Tauri-сборку. Исправление: использовать Windows-сборку либо собирать исходники с Node.js 18+, Rust stable и платформенными зависимостями Tauri. Проверка: локально собранное приложение запускается как Komodo PDF на целевой системе.

FAQ

Можно ли редактировать текст PDF в Komodo PDF?

Нет. Версия 0.1.1 является ридером с AI-панелью. В интерфейсе и заявленной области проекта нет редактирования текста или изображений, перестановки страниц и сохранения изменённого PDF.

Есть ли встроенный OCR?

Нет. Страница без текстового слоя получает метку No text layer — AI unavailable here. Для AI-работы со сканом нужен PDF, в котором OCR уже создал текстовый слой.

Можно ли использовать Komodo полностью офлайн?

Да, после подготовки локальных компонентов: Local embeddings должны быть скачаны, а chat Base URL должен указывать на работающий локальный OpenAI-compatible endpoint. Обычное чтение PDF офлайн работает и без AI.

Нужен ли именно OpenAI?

Нет. Интерфейс принимает OpenAI-compatible Base URL и имя модели. Это позволяет подключить совместимый облачный сервис, шлюз или локальный сервер.

Загружает ли Komodo весь PDF на свой сервер?

Нет, собственного Komodo backend нет. При удалённом chat режиме выбранному провайдеру передаются retrieved-фрагменты контекста, а при remote embeddings внешний endpoint обрабатывает текст для векторизации.

Где хранится индекс документа?

Индекс хранится локально в SQLite-векторном хранилище и связан с SHA-256 хешем файла. Поэтому одинаковый PDF можно распознать как уже индексированный, а изменившийся байтовый файл получает другой хеш.

Подходит ли программа для русскоязычных PDF?

В реестре локальных embeddings есть multilingual-e5-small, помеченная как multilingual. Интерфейс самой программы в 0.1.1 остаётся англоязычным.

Нужна ли регистрация в Komodo PDF?

Нет. У проекта нет собственного аккаунт-сервиса. Доступ к удалённому AI определяется выбранным провайдером, а полностью локальная схема не требует облачной учётной записи Komodo.

Можно ли сохранить AI-ответ в новый PDF одной кнопкой?

В текущем UI нет отдельной команды экспорта AI-ответа или создания нового PDF. Ответ остаётся частью панели Ask Komodo и не встраивается в исходный файл.

Почему после изменения PDF индекс строится заново?

Komodo связывает индекс с SHA-256 хешем файла. Изменение байтового содержимого меняет хеш, поэтому программа воспринимает изменённый PDF как другой вариант документа.

Есть ли готовая версия для macOS и Linux?

Готовые binaries версии 0.1.1 опубликованы только для Windows x64. macOS и Linux требуют самостоятельной сборки из исходников.

Итог по сценариям использования

Для чтения длинных текстовых PDF с проверяемым AI Komodo PDF соответствует задаче: документ остаётся в локальном ридере, индекс строится локально при выборе Local embeddings, а ответ ведёт к страницам и подсвечивает исходный текст. Главный контроль — не доверять краткому резюме без открытия p.N.

Для конфиденциальных документов смысл Komodo раскрывается только при полностью локальной конфигурации. Remote chat и Remote embeddings сознательно возвращают внешнюю зависимость, хотя исходный PDF не уходит на сервер Komodo целиком.

Для обычного PDF-редактирования продукт не подходит: отсутствие OCR, аннотаций, подписи, конвертации и сохранения изменённого файла — фундаментальное ограничение 0.1.1. Здесь разумнее выбрать Acrobat, Foxit или PDFgear в зависимости от требуемого набора операций.

Для минималистичного офлайн-чтения без AI Komodo работает, но его настройка и RAG-инфраструктура становятся лишними. SumatraPDF проще и поддерживает больше форматов чтения.

Для организации решение интересно открытым кодом, MSI-пакетом и отсутствием собственного backend, но ранняя версия, one-person разработка и неподписанный Windows-бинарник требуют собственной оценки рисков. Komodo PDF стоит рассматривать как специализированный локальный reader/RAG client, а не как универсальную платформу документооборота.