MinerU CLI
MinerU — CLI с библиотекой документов: уже разобранный отчет можно искать и читать повторно из локального кеша.
- 83 203 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает документы и сохраняет библиотечный кеш; удаленный режим передает документ внешнему обработчику.
- Doclib по умолчанию собирает диагностическую телеметрию без содержимого документов.
Установка
Ручная установка
npx skills add opendatalab/MinerU --skill mineru --global --yesПервый агентский способ README: устанавливает скилл, CLI ставится отдельно.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает документы и сохраняет библиотечный кеш; удаленный режим передает документ внешнему обработчику.
- Doclib по умолчанию собирает диагностическую телеметрию без содержимого документов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MinerU — CLI для разбора PDF, изображений и офисных документов в текст со структурой. Пользователь выбирает качество обработки, получает результат и может продолжить чтение с конкретной страницы или блока. В библиотечном режиме программа сохраняет результат разбора, поэтому при следующем поиске его не надо получать заново. Отдельная команда `mineru-kit parse` делает пакетное преобразование без библиотеки. Для работы через агента в README есть скилл, который устанавливается отдельно от самого CLI. Документы по умолчанию разбираются локально, удаленный режим включают явно.
Для кого. Аналитикам длинных отчетов, которым надо искать фрагменты, возвращаться к страницам и сохранять ссылки на источник.
Подходит, если
- Аналитик читает большой PDF несколькими порциями вместо одной длинной выгрузки.
- Агент ищет термин в локальной библиотеке и открывает найденную страницу.
- Команда готовит Markdown из офисного документа для дальнейшего анализа.
- Для сложного скана оператор выбирает качество обработки под доступное оборудование.
Не подходит, если
- Пользователь ставит только скилл и ожидает готовый исполняемый CLI без отдельной установки.
- Конфиденциальный документ отправляется удаленному обработчику без согласования пользователя.
- Команда выбирает Flash как окончательное чтение сложного PDF без сравнения качества.
Пример запроса к агенту
Разбери локальную копию отчета MinerU, найди упоминания расходов и покажи страницы-источники, не отправляя документ удаленно.Ограничения
Текущая ветка требует Python 3.11–3.14, поэтому старое окружение перед обновлением надо заменить. Офисные форматы используют локальный Flash-разбор, тогда как PDF и изображения поддерживают все четыре уровня качества. Для нейросетевых уровней нужны модели и подходящий запас памяти; требования зависят от выбранного движка. В библиотеке Doclib телеметрия первоначально включена, ее отключают через `mineru telemetry disable`; это не относится к отдельному `mineru-kit parse`.
Как отключить. Завершите задания и выполните `mineru server stop`, если использовали библиотечный сервер. Для отдельного конвертера остановите его процесс; кеш документов и выгрузки сохранятся.
Частые вопросы
Чем отличаются установки скилла и CLI?
Команда `npx skills add opendatalab/MinerU --skill mineru --global --yes` добавляет агенту инструкции работы с документами. Исполняемый CLI ставится отдельно в Python-окружение: после скилла выполните ручную установку из следующего ответа.
Как начинается ручная установка CLI?
Автор сначала дает `pip install uv`, затем `uv venv .mineru --python 3.12`. Активируйте это окружение способом своей ОС и выполните `uv pip install -U "mineru>=4.0,<5"`.
Как получить Markdown без библиотеки?
В Quick Start есть `mineru-kit parse document.pdf -o document.md --tier standard`. Замените входной файл и новое имя результата, затем просмотрите таблицы и порядок текста.
Что делать с server_not_running?
`mineru server start` запускает библиотечный сервер. Затем `mineru server status --json` покажет состояние и доступные уровни; до повторного разбора выберите поддерживаемый локальный режим.
Как продолжить чтение большого документа?
После чтения части документа ответ содержит `next_request.locator`, указатель следующего фрагмента. Попросите агента продолжить `mineru read` с этим указателем: он получит следующую часть и сохранит привязку к страницам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл и CLI без ключа и зависимостей: превращает PDF, Office и картинки в Markdown через облако MinerU.
Локальный CLI извлекает текст из документов и сканов, ищет материалы в архивах и готовит данные для ответа агента.
Docling — CLI для смешанного архива: PDF, документы и таблицы можно привести к общему формату для поиска и ИИ.
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
pdfcpu проверяет, объединяет и разделяет PDF, извлекает содержимое и управляет страницами через отдельный командный интерфейс.
Два скилла для Claude Code и Codex: агент переводит научные статьи в библиотеке EasyRead и отвечает на заметки на полях
Коротко о README
В README описаны библиотечный CLI, отдельный конвертер, API и WebUI. Четыре уровня качества отличаются требованиями к моделям и ресурсам. Условия кода основаны на Apache 2.0 с дополнениями в LICENSE.md.