O que é MinerU?
O MinerU converte PDFs, digitalizações e imagens, arquivos Word, PowerPoint, Excel, EPUB, OFD, HTML e CSV em Markdown, HTML, LaTeX, DOCX ou JSON estruturado, preservando tabelas, fórmulas e ordem de leitura. Ele é construído pela OpenDataLab, que também mantém o benchmark OmniDocBench, e seu modelo de visão, o MinerU2.5-Pro, é distribuído por ele.
A versão 4.0, lançada em 16 de setembro de 2026, o reorganizou em quatro níveis: o Flash lê a camada de texto do próprio PDF, o Basic acrescenta pequenos modelos de OCR, fórmulas e tabelas que rodam em CPU, e o Standard e o Advanced acrescentam o modelo de visão de 1,2 bilhão de parâmetros servido por llama.cpp, vLLM ou LMDeploy. Ela também adicionou uma biblioteca local de documentos que agentes podem pesquisar e citar por página e bloco. A versão 4.1 trouxe detecção automática de GPU em hardware Intel, AMD, NVIDIA e Apple e uma nova API assíncrona de Tasks.
A licença mudou em abril de 2026. A versão 3.1.0 substituiu a AGPLv3 pela MinerU Open Source License, Apache 2.0 com termos que exigem licença comercial acima de 100 milhões de usuários ativos mensais ou US$ 20 milhões de receita mensal, e exigem que serviços construídos sobre ela declarem que usam o MinerU.
MinerU vale a pena?
O modelo do MinerU está perto do topo do setor, e as evidências vão além da autodeclaração. A OpenDataLab informa 95,69 para o MinerU2.5-Pro no OmniDocBench v1.6, 2,71 pontos acima com a mesma arquitetura de 1.2B, só com trabalho de dados. A ressalva é que a OpenDataLab mantém o OmniDocBench e definiu a v1.6 no mesmo artigo. A tabela de um rival, no card do modelo Falcon OCR do TII, é mais modesta, mas ainda forte: 93,22 no OmniDocBench, atrás do PaddleOCR-VL-1.6, com 94,95, e 81,5 no olmOCR-bench, atrás só do dots.mocr, do Chandra OCR 2 e do próprio Falcon OCR nessa tabela.
A licença pede leitura cuidadosa. A saída da AGPLv3 em abril de 2026 eliminou a obrigação de copyleft, e os limites, 100 milhões de usuários mensais ou US$ 20 milhões de receita mensal, não vão atingir a maioria das empresas. Mas qualquer serviço online construído sobre o MinerU precisa dizer isso de forma destacada, e não fazê-lo encerra a licença automaticamente. Não é uma licença aprovada pela OSI, e algumas equipes jurídicas vão tratá-la como uma que precisam revisar. O histórico aumenta a cautela: o repositório trocou da AGPL para a Apache e voltou atrás em março de 2026 antes de se fixar em abril.
Os níveis são uma troca real. O Flash e o Basic rodam em CPUs comuns, e em uma máquina só com CPU o nível Standard só é ativado automaticamente com 12 ou mais núcleos lógicos; os níveis com modelo de visão pedem uma GPU, com 8 GB de VRAM descritos como ponto de partida para planejamento, e não como garantia. O card do modelo informa 2,12 páginas por segundo em uma A100 com vLLM. Os mantenedores do Marker mediram o pipeline mais antigo do MinerU em 72,7 no olmOCR-bench e 0,54 página por segundo em uma B200, então os resultados dependem muito do nível e da versão em uso.
O projeto anda rápido. Houve 18 versões entre a 4.0.0, em 16 de setembro, e a 4.1.4, em 2 de novembro, e a 4.1 quebrou a API HTTP, exigindo que servidores, roteadores, SDKs e clientes fossem atualizados juntos. Com 82.996 estrelas e só 11 issues abertas, a manutenção está claramente ativa; o custo é que fixar uma versão e ler o guia de migração fazem parte de operá-lo.
Onde ele se destaca
Um engenheiro de ML construindo recuperação sobre 500.000 artigos de pesquisa em chinês e inglês
Transformar PDFs com fórmulas e tabelas em Markdown limpo
Rode mineru-kit parse no nível Standard com vLLM em um host com GPU. Nas 2,12 páginas por segundo do card do modelo em uma A100, 5 milhões de páginas (dez por artigo) levam cerca de 27 dias em uma placa, então distribua entre GPUs com o Router multisserviço.
Uma equipe de plataforma dando a agentes de programação acesso a documentos internos
Deixar os agentes lerem documentos longos página por página e citarem locais exatos
Instale a skill mineru e inicie a biblioteca local de documentos; os agentes processam uma vez e depois leem por localizadores de documento, página e bloco, em vez de carregar arquivos inteiros. Os documentos não são enviados, a menos que o parsing remoto esteja configurado.
Um líder de operações jurídicas em uma empresa SaaS que embute um parser no produto
Verificar a licença antes de entregar o MinerU aos clientes
Abaixo dos limites de 100 milhões de usuários e US$ 20 milhões de receita mensal, não é preciso licença comercial, mas a interface do produto ou a documentação pública precisa declarar que usa o MinerU, ou a licença é encerrada.
Antes de decidir
- Configuração
- Python 3.11 a 3.14: uv pip install -U "mineru>=4.0,<5", depois mineru-kit parse document.pdf -o document.md --tier standard. Use mineru[full] para serving de alto throughput em NVIDIA; os modelos são baixados do Hugging Face ou do ModelScope.
- Integrações
- CLI, SDK Python (DoclibClient), APIs V1 HTTP e Tasks, um Router multisserviço, uma interface web em Gradio, uma skill de agente e uma opção de endpoint VLM remoto; nove formatos de saída, incluindo Markdown, HTML, LaTeX, DOCX e listas de conteúdo em JSON.
- Dados e privacidade
- Roda localmente; a documentação diz que os documentos não são enviados ao serviço oficial, a menos que o parsing remoto seja configurado explicitamente. Os pesos do MinerU2.5-Pro são Apache 2.0; o toolkit está sob a MinerU Open Source License.
- Custo em escala
- O custo auto-hospedado é hardware: o Flash e o Basic rodam em CPUs, a documentação recomenda pelo menos 16 GB de memória do sistema para uso com mais throughput, e o MinerU2.5-Pro chegou a 2,12 páginas por segundo em uma A100 com vLLM.
- Limites
- A seleção automática de nível não verifica a memória da GPU; o Docker para dispositivos não NVIDIA aguarda atualização; formatos do Office e da web usam só o Flash; as APIs HTTP mudaram de forma incompatível na 4.1.
O que é bom
- O MinerU2.5-Pro marca 93,22 no OmniDocBench na comparação de um rival (o TII)
- Quatro níveis, do parsing da camada de texto em CPU ao parsing com modelo de visão em GPU
- Office, EPUB, OFD, HTML e CSV processados nativamente
- Muito ativo: 18 versões entre meados de setembro e o início de novembro de 2026
O que não é
- Licença própria com obrigação de atribuição e limites de receita
- A OpenDataLab também administra o OmniDocBench, seu benchmark de destaque
- Mudança incompatível na API HTTP na 4.1
- O arquivo de licença alternou entre AGPL e Apache três vezes em março e abril de 2026
Ideal para
Equipes de RAG e de dados que processam grandes coleções mistas de PDFs e arquivos do Office no próprio hardware e aceitam uma cláusula de atribuição.
Alternativas ao MinerU
MinerU: perguntas frequentes
- MinerU vale a pena?
- O MinerU combina um dos modelos de documentos abertos mais precisos com um toolkit movimentado e bem documentado, embora sua licença já não seja open source pura e suas APIs continuem mudando. Damos nota 4.3 de 5.
- Quanto custa MinerU?
- Gratuito sob a MinerU Open Source License (Apache 2.0 com termos adicionais); uma licença comercial separada é exigida acima de 100 milhões de usuários ativos mensais ou US$ 20 milhões de receita mensal.
- Quais são as desvantagens de MinerU?
- Licença própria com obrigação de atribuição e limites de receita; a OpenDataLab também administra o OmniDocBench, seu benchmark de destaque; mudança incompatível na API HTTP na 4.1; o arquivo de licença alternou entre AGPL e Apache três vezes em março e abril de 2026.
- Para quem MinerU é indicado?
- Equipes de RAG e de dados que processam grandes coleções mistas de PDFs e arquivos do Office no próprio hardware e aceitam uma cláusula de atribuição.
- Quanto custa MinerU para uma equipe ou em produção?
- O custo auto-hospedado é hardware: o Flash e o Basic rodam em CPUs, a documentação recomenda pelo menos 16 GB de memória do sistema para uso com mais throughput, e o MinerU2.5-Pro chegou a 2,12 páginas por segundo em uma A100 com vLLM.
- MinerU é seguro para dados da empresa?
- Roda localmente; a documentação diz que os documentos não são enviados ao serviço oficial, a menos que o parsing remoto seja configurado explicitamente. Os pesos do MinerU2.5-Pro são Apache 2.0; o toolkit está sob a MinerU Open Source License.
- Quais são as melhores alternativas ao MinerU?
- As alternativas mais próximas que analisamos são Docling, Marker e Unstructured.
Respostas verificadas em 2 de nov. de 2026.
Você faz o MinerU? Mostre esta nota no seu site
