install.rst

Install 
===============================================================
If you encounter any installation issues, please first consult the :doc:`../../additional_notes/faq`.
If the parsing results are not as expected, refer to the :doc:`../../additional_notes/known_issues`.

Also you can try `online demo <https://www.modelscope.cn/studios/OpenDataLab/MinerU>`_ without installation.

.. admonition:: Warning
    :class: tip

    **Pre-installation Notice—Hardware and Software Environment Support**

    To ensure the stability and reliability of the project, we only optimize
    and test for specific hardware and software environments during
    development. This ensures that users deploying and running the project
    on recommended system configurations will get the best performance with
    the fewest compatibility issues.

    By focusing resources on the mainline environment, our team can more
    efficiently resolve potential bugs and develop new features.

    In non-mainline environments, due to the diversity of hardware and
    software configurations, as well as third-party dependency compatibility
    issues, we cannot guarantee 100% project availability. Therefore, for
    users who wish to use this project in non-recommended environments, we
    suggest carefully reading the documentation and FAQ first. Most issues
    already have corresponding solutions in the FAQ. We also encourage
    community feedback to help us gradually expand support.

.. raw:: html

    <style>
        table, th, td {
        border: 1px solid black;
        border-collapse: collapse;
        }
    </style>
    <table>
    <tr>
        <td colspan="3" rowspan="2">Operating System</td>
    </tr>
    <tr>
        <td>Linux after 2019</td>
        <td>Windows 10 / 11</td>
        <td>macOS 11+</td>
    </tr>
    <tr>
        <td colspan="3">CPU</td>
        <td>x86_64 / arm64</td>
        <td>x86_64(unsupported ARM Windows)</td>
        <td>x86_64 / arm64</td>
    </tr>
    <tr>
        <td colspan="3">Memory Requirements</td>
        <td colspan="3">16GB or more, recommended 32GB+</td>
    </tr>
    <tr>
        <td colspan="3">Storage Requirements</td>
        <td colspan="3">20GB or more, with a preference for SSD</td>
    </tr>
    <tr>
        <td colspan="3">Python Version</td>
        <td colspan="3">3.10~3.12</td>
    </tr>
    <tr>
        <td colspan="3">Nvidia Driver Version</td>
        <td>latest (Proprietary Driver)</td>
        <td>latest</td>
        <td>None</td>
    </tr>
    <tr>
        <td colspan="3">CUDA Environment</td>
        <td>11.8/12.4/12.6/12.8</td>
        <td>11.8/12.4/12.6/12.8</td>
        <td>None</td>
    </tr>
    <tr>
        <td colspan="3">CANN Environment(NPU support)</td>
        <td>8.0+(Ascend 910b)</td>
        <td>None</td>
        <td>None</td>
    </tr>
    <tr>
        <td rowspan="2">GPU/MPS Hardware Support List</td>
        <td colspan="2">GPU VRAM 6GB or more</td>
        <td colspan="2">All GPUs with Tensor Cores produced from Volta(2017) onwards.<br>
        More than 6GB VRAM </td>
        <td rowspan="2">Apple silicon</td>
    </tr>
    </table>



Create an environment
---------------------------

.. code-block:: shell

    conda create -n mineru 'python>=3.10' -y
    conda activate mineru
    pip install -U "magic-pdf[full]"


Download model weight files
------------------------------

.. code-block:: shell

    pip install huggingface_hub
    wget https://github.com/opendatalab/MinerU/raw/master/scripts/download_models_hf.py -O download_models_hf.py
    python download_models_hf.py    



Install LibreOffice[Optional]
----------------------------------

This section is required for handle **doc**, **docx**, **ppt**, **pptx** filetype, You can **skip** this section if no need for those filetype processing.


Linux/Macos Platform
""""""""""""""""""""""

.. code::

    apt-get/yum/brew install libreoffice


Windows Platform 
""""""""""""""""""""

.. code::

    install libreoffice 
    append "install_dir\LibreOffice\program" to ENVIRONMENT PATH


.. tip::

    The MinerU is installed, Check out :doc:`../usage/command_line` to convert your first pdf **or** reading the following sections for more details about install