windows macos 一键安装脚本，需要请自取

[ChainZeaxion]

使用前，请自行查看脚本内容，针对你的自有环境进行适配

一、macos版

注意事项！ python需要固定在3.10-3.12
具体目录请自行修改变量位置，全局默认的情况下，会在终端当前执行用户的用户根目录下创建mineru_macos目录。
安装完成后，所有文件均在mineru_macos目录中生成，卸载直接删除本体目录即可，环境变量请自行undo或删除

代码本体：

#!/bin/bash

=========================================================

MinerU-macOS 一键式安装脚本 (v2.1 全隔离版)

=========================================================

echo -e "\033[36m--- 开始安装 MinerU: Apple Silicon 深度优化版 ---\033[0m"

1. 创建并进入隔离目录

VENV_NAME="mineru_macos"
mkdir -p $VENV_NAME && cd $VENV_NAME

2. 初始化虚拟环境 (使用 uv)

unalias python 2>/dev/null
uv venv --python 3.10
source bin/activate

3. 配置持久化环境变量 (核心隔离逻辑)

获取当前虚拟环境的绝对路径

BASE_DIR=$(pwd)

echo "export MODELSCOPE_CACHE="$BASE_DIR/models"" >> bin/activate
echo "export MINERU_MODEL_SOURCE="modelscope"" >> bin/activate
echo "export PIP_CACHE_DIR="$BASE_DIR/pip_cache"" >> bin/activate
echo "export HF_HOME="$BASE_DIR/hf_cache"" >> bin/activate
echo "export GRADIO_SERVER_NAME="0.0.0.0"" >> bin/activate
echo "export GRADIO_SERVER_PORT="8808"" >> bin/activate

立即应用变量

source bin/activate

4. 安装依赖与核心包

brew install libmagic
python -m pip install -U pip
pip install -U "mineru[all]" --index-url https://mirrors.aliyun.com/pypi/simple/

5. 下载模型权重

python -m mineru.cli.models_download -s modelscope -m all

6. 生成自适应 mineru.json (指向隔离路径)

cat < ~/mineru.json
{
"models-dir": {
"pipeline": "$BASE_DIR/models/hub/models/OpenDataLab/PDF-Extract-Kit-1___0",
"vlm": "$BASE_DIR/models/hub/models/OpenDataLab/MinerU2___5-2509-1___2B"
},
"device-mode": "mps",
"vlm-config": {
"enabled": true,
"precision": "fp16"
},
"latex-delimiter-config": {
"display": { "left": "$$", "right": "$$" },
"inline": { "left": "$", "right": "$" }
},
"config_version": "1.3.1"
}
EOF

7. 注入 macOS 专属补丁 (解决 Fork Safety 警告)

grep -q "OBJC_DISABLE_INITIALIZE_FORK_SAFETY" ~/.zshrc || echo 'export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES' >> ~/.zshrc

echo -e "\033[32m✅ 安装成功！\033[0m"
echo -e "\033[35m[隔离提示]\033[0m 模型与缓存全部位于: $BASE_DIR"
echo -e "\033[35m[启动指令]\033[0m 请先执行: source bin/activate 然后执行: mineru-gradio"

代码结束！！！

二、windows版本，分为powershell与bat双版

注意事项！ python需要固定在3.10-3.12，
具体目录请自行修改变量位置，全局默认的情况下，会在windows的anaconda安装目录下的“虚拟环境目录对应项目目录”中。

powershell 代码版
代码本体：

=========================================================

MinerU-Windows 一键式安装脚本 (v2.1 全隔离版)

=========================================================

Write-Host "--- 准备开始安装 MinerU (Windows 全隔离版) ---" -ForegroundColor Cyan

1. 环境创建

$envName = "mineru"
conda create -n $envName python=3.10 -y

激活环境以便后续操作

$anacondaPath = (conda info --base)
$baseDir = "$anacondaPath\envs$envName"

Write-Host "[隔离路径] 目标文件夹: $baseDir" -ForegroundColor Yellow

2. 设置永久环境变量 (用户级)

这样即使不通过激活脚本，系统也能识别隔离路径

[Environment]::SetEnvironmentVariable("MODELSCOPE_CACHE", "$baseDir\models", "User")
[Environment]::SetEnvironmentVariable("MINERU_MODEL_SOURCE", "modelscope", "User")
[Environment]::SetEnvironmentVariable("GRADIO_SERVER_NAME", "0.0.0.0", "User")
[Environment]::SetEnvironmentVariable("GRADIO_SERVER_PORT", "8808", "User")

3. 临时设置当前会话变量并安装

$env:MODELSCOPE_CACHE = "$baseDir\models"
$env:PIP_CACHE_DIR = "$baseDir\pip_cache"
$env:HF_HOME = "$baseDir\hf_cache"

& "$baseDir\python.exe" -m pip install -U pip
& "$baseDir\pip.exe" install -U "mineru[all]" --index-url https://mirrors.aliyun.com/pypi/simple/

4. 执行模型下载

& "$baseDir\python.exe" -m mineru.cli.models_download -s modelscope -m all

5. 生成优化后的 mineru.json (存放在用户根目录)

$jsonPath = "$env:USERPROFILE\mineru.json"
$config = @{
"models-dir" = @{
"pipeline" = "$baseDir\models\hub\models\OpenDataLab\PDF-Extract-Kit-1___0"
"vlm" = "$baseDir\models\hub\models\OpenDataLab\MinerU2___5-2509-1___2B"
}
"device-mode" = "cuda"
"vlm-config" = @{ "enabled" = $true; "precision" = "bfloat16" }
"latex-delimiter-config" = @{
"display" = @{ "left" = "$$"; "right" = "$$" }
"inline" = @{ "left" = "$"; "right" = "$" }
}
"config_version" = "1.3.1"
} | ConvertTo-Json -Depth 10

$config | Out-File -FilePath $jsonPath -Encoding utf8

Write-Host "✅ 安装完成！请执行 'conda activate mineru' 后启动 'mineru-gradio'。" -ForegroundColor Green

代码结束！！！

bat版
代码本体：
@echo off
setlocal enabledelayedexpansion

echo =========================================================
echo MinerU-Windows 一键式安装脚本 (BAT 全隔离版)
echo =========================================================

:: 1. 创建环境
set "ENV_NAME=mineru"
call conda create -n %ENV_NAME% python=3.10 -y

:: 2. 自动捕获 Anaconda 路径
for /f "tokens=*" %%i in ('conda info --base') do set "CONDA_BASE=%%i"
set "BASE_DIR=%CONDA_BASE%\envs%ENV_NAME%"

echo [*] 隔离路径确认: %BASE_DIR%

:: 3. 写入永久环境变量 (用户级)
setx MODELSCOPE_CACHE "%BASE_DIR%\models"
setx MINERU_MODEL_SOURCE "modelscope"
setx GRADIO_SERVER_PORT "8808"
setx GRADIO_SERVER_NAME "0.0.0.0"

:: 4. 激活环境并安装 (临时设置缓存目录防止污染 C 盘)
set "PIP_CACHE_DIR=%BASE_DIR%\pip_cache"
set "HF_HOME=%BASE_DIR%\hf_cache"

call conda activate %ENV_NAME%
python -m pip install -U pip
pip install -U "mineru[all]" --index-url https://mirrors.aliyun.com/pypi/simple/
python -m mineru.cli.models_download -s modelscope -m all

:: 5. 使用 PowerShell 辅助生成正确的 JSON (处理转义字符)
powershell -Command "$config = @{ 'models-dir' = @{ 'pipeline' = '%BASE_DIR%\models\hub\models\OpenDataLab\PDF-Extract-Kit-1___0'; 'vlm' = '%BASE_DIR%\models\hub\models\OpenDataLab\MinerU2___5-2509-1___2B' }; 'device-mode' = 'cuda'; 'vlm-config' = @{ 'enabled' = $true; 'precision' = 'bfloat16' }; 'latex-delimiter-config' = @{ 'display' = @{ 'left' = '$$'; 'right' = '$$' }; 'inline' = @{ 'left' = '$'; 'right' = '$' } }; 'config_version' = '1.3.1' } | ConvertTo-Json -Depth 10; $config | Out-File -FilePath "$env:USERPROFILE\mineru.json" -Encoding utf8"

echo ✅ Windows 全隔离环境部署完毕！端口已固定为 8808。
pause

代码结束

有需要请自取，其它帮助请参阅官方文档及其它开发者相关经验。