DocMeld CLI
CLI и библиотека Python делают из PDF, Word и PowerPoint элементы JSON, страницы JSONL и скиллы без OCR и моделей.
- 101 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Золотая стадия и генерация знаний отправляют текст документов во внешний сервис DeepSeek.
- Обработка читает и записывает файлы в рабочих папках.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/docmeldОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Золотая стадия и генерация знаний отправляют текст документов во внешний сервис DeepSeek.
- Обработка читает и записывает файлы в рабочих папках.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
DocMeld проводит документ через три стадии. Бронза превращает файл в структурированный JSON с элементами: заголовки, таблицы, изображения, формулы, заметки докладчика. Серебро собирает самостоятельные страницы JSONL с иерархией заголовков и таблицами в Markdown, пригодные для поиска и RAG. Золото обогащает страницы метаданными через DeepSeek. Команды `process`, `bronze`, `silver`, `gold` идемпотентны: повторный запуск пропускает обработанные файлы. С версии 0.3.1 есть команды `categorize`, `prd`, `workflow` и `skills`, которые строят по тексту книги или статьи кластеры тем, документ требований, пошаговый процесс и файлы скиллов Claude Code.
Для кого. Разработчикам RAG и агентных систем, которым нужен легкий разбор документов без тяжелых моделей и с предсказуемой схемой элементов.
Подходит, если
- Папка PDF и презентаций должна превратиться в постраничные JSONL для индексации.
- По книге нужно получить набор скиллов Claude Code.
- К каждой странице отдельным проходом добавляют описание и ключевые слова.
- Статьи в папке надо разложить по темам с файлом `categories.json`.
Не подходит, если
- Нужен распознаватель сканов: DocMeld читает текстовый слой и не включает OCR.
- Документы нельзя отправлять во внешний сервис: золотая стадия и генерация знаний обращаются к DeepSeek.
- Необходим MCP-сервер: в репозитории только CLI и библиотека.
Пример запроса к агенту
Обработай все PDF и PPTX из папки reports командой `docmeld process`, покажи число страниц и таблиц, затем сгенерируй скиллы из книги guide.pdf.Ограничения
Бронза и серебро работают офлайн и без ключей, золото и команды `categorize`, `prd`, `workflow`, `skills` требуют `DEEPSEEK_API_KEY` в `.env.local` и отправляют текст страниц в DeepSeek. Форматы `.doc` и `.ppt` читаются через LibreOffice, а `.docx` и расширенный разбор PDF требуют дополнительных пакетов (`docmeld[docling]`, `docmeld[pptx]`). Нужен Python 3.9 или новее. Последний коммит от сентября 2026 года, версия PyPI 0.3.1. Лицензия MIT указана в README.
Как отключить. Выполните `pip uninstall docmeld`. Результаты обработки лежат в папках рядом с документами, их удаляют вручную.
Частые вопросы
Как установить DocMeld?
Командой `pip install docmeld`. Дополнения ставятся так: `pip install docmeld[docling]` для DOCX и расширенного PDF, `docmeld[pptx]` для PowerPoint, `docmeld[office]` для всего сразу.
Нужны ли модели для разбора?
Нет. Бронза и серебро работают без OCR, VLM и мультимодальных моделей, офлайн и без ключей. ИИ нужен только для золотой стадии и генерации знаний.
Что такое золотая стадия?
Необязательный проход с повторами при сбоях: ошибка одной страницы не останавливает остальные.
Как получить скиллы из книги?
Командой `docmeld skills book.pdf` либо методом `parser.process_skills()`. Нужен `DEEPSEEK_API_KEY`, результат — файлы скиллов Claude Code.
Можно ли подключить другую модель?
Да, генерация знаний работает через протокол `LLMProvider`, поэтому бэкенд заменяется. Парсеры PDF также переключаются флагом `--backend`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыget-md превращает HTML-страницы, PDF, DOCX и Markdown в чистый Markdown для языковых моделей из командной строки или кода.
minirag-mcp ищет по вашим документам гибридным поиском на векторах и BM25 и работает на компьютере, без отправки файлов наружу
CLI-движок, который собирает из документов локальную структурированную вики: прозрачная альтернатива обычному RAG с доступом для агента по MCP
CLI и MCP-сервер для извлечения структурированных знаний из документов: графы, гиперграфы и поиск по фактам с источниками
Подключает библиотеку Zotero к Claude и другим агентам: поиск статей, аннотации, ссылки и семантический поиск по смыслу
MCP-сервер дает агенту поиск и ответы по локальным документам с гибридным индексом, повторным ранжированием и ссылками на разделы.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| DocMeld (эта карточка) | нет | 101 | ||
| Docling | нет | 70 497 | CLI для приведения смешанного архива к общему формату; DocMeld делает постраничный JSONL с иерархией заголовков и генерирует скиллы | |
| MarkItDown | да | не нужна | 195 008 | утилита Microsoft и MCP, переводящая файлы в Markdown; DocMeld строит трехстадийный конвейер и схему элементов |
Коротко о README
Проект строит конвейер «бронза, серебро, золото» вместо простой конвертации формата: каждая стадия запускается отдельно, схема из 14 типов элементов проверяется Pydantic. В README есть таблица сравнения с MinerU, Docling, Marker и MarkItDown.