faq.rst 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. 常见问题解答
  2. ============
  3. 1.在较新版本的mac上使用命令安装pip install magic-pdf[full] zsh: no matches found: magic-pdf[full]
  4. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  5. 在 macOS 上,默认的 shell 从 Bash 切换到了 Z shell,而 Z shell
  6. 对于某些类型的字符串匹配有特殊的处理逻辑,这可能导致no matches
  7. found错误。 可以通过在命令行禁用globbing特性,再尝试运行安装命令
  8. .. code:: bash
  9. setopt no_nomatch
  10. pip install magic-pdf[full]
  11. 2.使用过程中遇到_pickle.UnpicklingError: invalid load key, ‘v’.错误
  12. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  13. 可能是由于模型文件未下载完整导致,可尝试重新下载模型文件后再试
  14. 参考:https://github.com/opendatalab/MinerU/issues/143
  15. 3.模型文件应该下载到哪里/models-dir的配置应该怎么填
  16. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  17. 模型文件的路径输入是在”magic-pdf.json”中通过
  18. .. code:: json
  19. {
  20. "models-dir": "/tmp/models"
  21. }
  22. 进行配置的。
  23. 这个路径是绝对路径而不是相对路径,绝对路径的获取可在models目录中通过命令
  24. “pwd” 获取。
  25. 参考:https://github.com/opendatalab/MinerU/issues/155#issuecomment-2230216874
  26. 4.在WSL2的Ubuntu22.04中遇到报错\ ``ImportError: libGL.so.1: cannot open shared object file: No such file or directory``
  27. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  28. WSL2的Ubuntu22.04中缺少\ ``libgl``\ 库,可通过以下命令安装\ ``libgl``\ 库解决:
  29. .. code:: bash
  30. sudo apt-get install libgl1-mesa-glx
  31. 参考:https://github.com/opendatalab/MinerU/issues/388
  32. 5.遇到报错 ``ModuleNotFoundError : Nomodulenamed 'fairscale'``
  33. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  34. 需要卸载该模块并重新安装
  35. .. code:: bash
  36. pip uninstall fairscale
  37. pip install fairscale
  38. 参考:https://github.com/opendatalab/MinerU/issues/411
  39. 6.在部分较新的设备如H100上,使用CUDA加速OCR时解析出的文字乱码。
  40. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  41. cuda11对新显卡的兼容性不好,需要升级paddle使用的cuda版本
  42. .. code:: bash
  43. pip install paddlepaddle-gpu==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cu123/
  44. 参考:https://github.com/opendatalab/MinerU/issues/558
  45. 7.在部分Linux服务器上,程序一运行就报错 ``非法指令 (核心已转储)`` 或 ``Illegal instruction (core dumped)``
  46. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  47. 可能是因为服务器CPU不支持AVX/AVX2指令集,或cpu本身支持但被运维禁用了,可以尝试联系运维解除限制或更换服务器。
  48. 参考:https://github.com/opendatalab/MinerU/issues/591 ,
  49. https://github.com/opendatalab/MinerU/issues/736