opendatalab/MinerU

O que é?

Recursos principais

• 01Converte PDFs, imagens digitalizadas, arquivos do Office, EPUB, HTML e CSV em Markdown ou JSON.
• 02Oferece quatro níveis de qualidade, do processamento rápido no modo Flash ao modo Advanced para layouts complexos.
• 03Exporta para nove formatos, incluindo Markdown, HTML, LaTeX, DOCX e EPUB.
• 04Executa modelos localmente em CPU, GPU ou Apple Silicon, usando processamento remoto somente quando configurado.
• 05Oferece CLI, SDK Python, API e WebUI em Gradio, além de uma biblioteca local de documentos com busca.

Casos de uso

• Inserir relatórios em PDF ou artigos acadêmicos em um pipeline de LLM ou RAG como Markdown limpo.
• Extrair tabelas e fórmulas de documentos digitalizados para análise.
• Permitir que agentes de IA leiam documentos longos página por página, com identificadores citáveis.
• Converter arquivos do Office e do OpenDocument em lote para texto estruturado.

Início rápido

1. 1

   Instale uv com pip

   pip install uv
2. 2

   Crie um ambiente virtual com Python 3.12

   uv venv .mineru --python 3.12
3. 3

   Instale o MinerU 4.0 stable no ambiente (ative o venv primeiro, conforme o README)

   uv pip install -U "mineru>=4.0,<5"
4. 4

   Converta um PDF para Markdown

   mineru-kit parse document.pdf -o document.md --tier standard

Antes de usar

• !Não foi possível identificar a licença automaticamente, então verifique o repositório antes de usar o projeto comercialmente.
• !Para obter o máximo desempenho, é necessária uma GPU NVIDIA; outros dispositivos que não sejam NVIDIA exigem a instalação manual de uma versão acelerada do torch e do vllm ou lmdeploy.
• !No Windows, a versão do torch com suporte a GPU precisa ser instalada separadamente.

Tópicos

Perguntas frequentes

O que é MinerU?

Parser de documentos open source que converte PDFs, arquivos do Office e imagens em Markdown ou JSON para fluxos de trabalho com LLMs e agentes. O MinerU converte documentos complexos, como PDFs, imagens digitalizadas, arquivos do Word, PowerPoint e Excel, EPUB, HTML e CSV, em conteúdo estruturado. A saída pode ser gerada como Markdown, HTML, LaTeX, DOCX, EPUB, PDF ou listas de conteúdo em JSON estruturado, o que torna o projeto adequado para servir de entrada a pipelines de RAG e aplicações com LLMs.

MinerU é gratuito? Qual é a licença?

MinerU é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.

MinerU ainda é mantido?

Manutenção ativa. O último commit de MinerU foi em 19 de out. de 2026.

Para que posso usar MinerU?

Inserir relatórios em PDF ou artigos acadêmicos em um pipeline de LLM ou RAG como Markdown limpo. Extrair tabelas e fórmulas de documentos digitalizados para análise. Permitir que agentes de IA leiam documentos longos página por página, com identificadores citáveis. Converter arquivos do Office e do OpenDocument em lote para texto estruturado.

Como instalar MinerU?

Instale uv com pip: pip install uv Crie um ambiente virtual com Python 3.12: uv venv .mineru --python 3.12 Instale o MinerU 4.0 stable no ambiente (ative o venv primeiro, conforme o README): uv pip install -U "mineru>=4.0,<5" Converta um PDF para Markdown: mineru-kit parse document.pdf -o document.md --tier standard

Onde consigo MinerU?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/opendatalab/MinerU