換實戰(zhàn)筆記)
一個命令跑通 MinerUPDF 轉(zhuǎn)換實戰(zhàn)筆記【免費下載鏈接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.項目地址: https://gitcode.com/GitHub_Trending/mi/MinerU手里有份 200 頁的掃描 PDF要轉(zhuǎn)成能編輯的 Markdown手動復制行不通。MinerU 把 PDF、圖片和 Office 文檔解析成 LLM 能直接用的 Markdown 與 JSON。按你的硬件和場景選一條路裝完就能轉(zhuǎn)。裝 core 就能跑MinerU 第一份 PDF 怎么轉(zhuǎn)裝完你手里多了一個mineru命令行工具輸入 PDF、圖片或 docx/pptx/xlsx輸出 Markdown 和 JSON。core 模塊把解析所需的全部依賴一次裝齊模型首次運行時自動下載需要聯(lián)網(wǎng)。uv pip install mineru[core] mineru -p input.pdf -o output/第二行跑通后output/下按頁生成 Markdown。默認走 hybrid-engine 后端換 pipeline、vlm-engine 或調(diào)解析參數(shù)見 CLI 參數(shù)文檔。有顯卡才走這條路MinerU vllm 加速與顯存配置門檻先說清Turing 架構(gòu)及以上、顯存 ≥8G不滿足直接跳過本節(jié)。uv pip install mineru[all]在 Linux 上mineru[all]等價于 core vllm s3 合并安裝一條命令到位。裝完設兩個環(huán)境變量export MINERU_DEVICE_MODEcuda export MINERU_VIRTUAL_VRAM_SIZE16 # 按實際顯存改加速原理只記結(jié)論vllm 用 PagedAttention 管理 KV 緩存減少顯存浪費批量推理比默認引擎快 3~5 倍。服務端實現(xiàn)在mineru/model/vlm/想摳細節(jié)再看。 本機算力不夠輕量客戶端連遠程推理服務三種情況適用本機沒顯卡、不想裝重依賴、只想連遠程 vllm-server。服務端跑mineru-vllm-server客戶端只裝基礎包體積 50MBuv pip install mineru mineru -p input.pdf -o output/ --backend vlm-http-client --url http://127.0.0.1:30000客戶端把頁面通過 HTTP 發(fā)給遠端做推理本地只處理返回結(jié)果跑 200 頁掃描件也不吃本機顯存。整體架構(gòu)與數(shù)據(jù)流見下圖。這幾個環(huán)境變量開關最常用默認配置能覆蓋大多數(shù)文檔想換模型下載源、限定顯存上限、關掉公式或表格識別來省時間時才需要動下面這些開關。變量名干什么的常見取值MINERU_MODEL_SOURCE模型下載源modelscope / localMINERU_DEVICE_MODE設備模式cuda / cpuMINERU_VIRTUAL_VRAM_SIZE推理顯存上限8 / 16MINERU_FORMULA_ENABLE公式解析開關true / falseMINERU_TABLE_ENABLE表格識別開關true / false完整列表在 CLI 參數(shù)文檔 里。裝不上、跑不對時先查這幾種癥狀vllm 安裝反復失敗大概率是本地依賴版本沖突。別跟依賴死磕換預構(gòu)建鏡像看 Docker 部署指南。中文輸出亂碼文檔語言沒判對。跑轉(zhuǎn)換時加-l ch指定語言OCR 準確率會直接上來。大文檔顯存溢出推理批量開大了。先把MINERU_VIRTUAL_VRAM_SIZE調(diào)小再用-s/-e分段轉(zhuǎn)頁面。都解決不了先翻 FAQ再不到去倉庫 issue 區(qū)提單。個人日常轉(zhuǎn)換core 加遠程客戶端就夠批量任務或精度要求高走 vllm 那條路。想讀源碼git clone https://gitcode.com/GitHub_Trending/mi/MinerU【免費下載鏈接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.項目地址: https://gitcode.com/GitHub_Trending/mi/MinerU創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考