
Download Model Weight Files
==============================

Model downloads are divided into initial downloads and updates to the
model directory. Please refer to the corresponding documentation for
instructions on how to proceed.

Initial download of model files
------------------------------

1. Download the Model from Hugging Face
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Use a Python Script to Download Model Files from Hugging Face

.. code:: bash

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

The Python script will automatically download the model files and
configure the model directory in the configuration file.

The configuration file can be found in the user directory, with the
filename ``magic-pdf.json``.

How to update models previously downloaded
-----------------------------------------

1. Models downloaded via Git LFS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

   Due to feedback from some users that downloading model files using
   git lfs was incomplete or resulted in corrupted model files, this
   method is no longer recommended.

If you previously downloaded model files via git lfs, you can navigate
to the previous download directory and use the ``git pull`` command to
update the model.

2. Models downloaded via Hugging Face or Model Scope
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you previously downloaded models via Hugging Face or Model Scope, you
can rerun the Python script used for the initial download. This will
automatically update the model directory to the latest version.
