《Local-File-Organizer 安装与配置指南》

1. 项目基础介绍

Local-File-Organizer 是一个本地文件整理工具，它使用先进的AI技术自动扫描、分类和重命名您电脑上的文件，让您的文件管理变得井井有条。该项目主要使用 Python 编程语言实现。

2. 项目使用的关键技术和框架

项目使用的关键技术包括：

• Nexa SDK：支持AI模型本地运行的软件开发工具包。
• Llama3.2 3B：用于文本分析的语言模型。
• LLaVA-v1.6：基于 Vicuna-7B 的视觉语言模型，用于图像分析。

使用的框架和库包括：

• PyTesseract：OCR文字识别库。
• PyMuPDF (fitz)：用于处理PDF文件的库。
• Pillow：图像处理库。

3. 项目安装和配置的准备工作

在开始安装前，请确保您的系统满足以下要求：

• 操作系统：兼容 Windows、macOS 和 Linux。
• Python 版本：Python 3.12。
• Conda：安装 Anaconda 或 Miniconda。
• Git：用于克隆仓库（或者您可以下载代码的ZIP文件）。

详细安装步骤

1. 安装 Python

   首先确保您的系统中安装了 Python。推荐使用 Python 3.12 或更高版本。从 Python 官方网站下载并按照操作系统的指示进行安装。

2. 克隆仓库

   使用 Git 克隆仓库到您的本地机器：

   git clone https://github.com/QiuYannnn/Local-File-Organizer.git
   

   或者下载仓库的ZIP文件并解压到您选择的位置。

3. 设置 Python 环境

   创建一个名为 local_file_organizer 的新 Conda 环境，并指定 Python 版本为 3.12：

   conda create --name local_file_organizer python=3.12
   

   激活环境：

   conda activate local_file_organizer
   

4. 安装 Nexa SDK

   根据您的系统选择适当的安装命令：

   • CPU 安装：

     pip install nexaai --prefer-binary --index-url https://nexaai.github.io/nexa-sdk/whl/cpu --extra-index-url https://pypi.org/simple --no-cache-dir
     

   • GPU 安装（Metal - macOS）：

     CMAKE_ARGS="
     -DGGML_METAL=ON -DSD_METAL=ON
     "
     pip install nexaai --prefer-binary --index-url https://nexaai.github.io/nexa-sdk/whl/metal --extra-index-url https://pypi.org/simple --no-cache-dir
     

   • CUDA 和 AMD GPU 支持：请参考主README中的安装指南。

5. 安装依赖

   切换到项目目录：

   cd path/to/Local-File-Organizer
   

   替换 path/to/Local-File-Organizer 为您克隆或解压项目实际的路径。

   安装所需的依赖：

   pip install -r requirements.txt
   

   如果遇到任何包的安装问题，尝试单独安装：

   pip install nexa Pillow pytesseract PyMuPDF python-docx
   

6. 运行脚本

   确保环境已激活且依赖项已安装，然后运行脚本：

   python main.py
   

注意：确保您已经设置了所需的OCR工具和模型路径。根据您的操作系统安装Tesseract OCR。处理时间可能会根据文件的数量和大小而有所不同。脚本使用了多进程来加速处理。

以上就是Local-File-Organizer的详细安装与配置指南，按照上述步骤操作，您应该能够顺利安装并运行该项目。