Local File Organizer : assistant d'organisation de fichiers locaux, organisateur de fichiers automatique AI

Introduction générale

Local File Organizer 是一个由 AI 驱动的本地文件管理工具，旨在帮助用户整理和分类计算机上的文件。该工具利用先进的 AI 模型，如 Llama3.2 3B 和 Llava v1.6，通过 Nexa SDK 实现文件的智能扫描、重组和分类，确保用户隐私的同时提供高效的文件管理体验。

简单来说，本地文件整理器会扫描你指定的文件夹，根据文件的内容，自动给它们打标签、分类、生成新的文件名，还能放到对应的文件夹里。

全程不用联网，所有的处理都在你自己的设备上完成。

只要你输入两个路径，一个是需要整理的文件夹路径，另一个是想保存整理后文件的文件夹路径，AI就会开始工作。

Liste des fonctions

• 文件扫描：自动扫描指定目录下的所有文件。
• analyse du contenu：使用语言模型和视觉语言模型分析文件内容。
• 文件分类：根据内容、日期和类型对文件进行分类。
• 文件重命名：生成相关描述和文件名。
• Vie privée：所有操作均在本地完成，无需联网。
• Prise en charge de plusieurs documents：支持文本、图片、PDF、Excel、PPT、CSV 等多种文件格式。
• 实时进度条：显示文件分析的实时进度。
• 静默模式：保存所有日志到文本文件，减少操作噪音。
• 干运行模式：在提交更改前检查排序结果。

Utiliser l'aide

安装 🛠

对于 SDK 安装和模型相关问题，请在 Voici Publié.

1. 安装 Python

在安装本地文件组织器之前，请确保您的系统上已安装 Python。我们建议使用 Python 3.12 或更高版本。

您可以从官方网站下载 Python。

请按照您操作系统的安装说明进行操作。

2. clonage de la base de code

使用 Git 将此代码库克隆到您的本地机器：

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

或者将代码库下载为 ZIP 文件并提取到您希望的位置。

3. 设置 Python 环境

Créer un fichier nommé 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 安装

要安装 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)

要安装支持 Metal (macOS) 的 GPU 版本，请运行：

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 répondre en chantant GPU AMD 的 Nexa SDK 的详细安装说明，请参阅主 README 中的 安装部分.

5. 安装依赖

1. 确保您在项目目录中：

   cd path/to/Local-File-Organizer
   

   commandant en chef (militaire) path/to/Local-File-Organizer 替换为您克隆或提取项目的实际路径。

2. Installer les dépendances nécessaires :

   pip install -r requirements.txt
   

Attention : 如果您在任何包上遇到问题，请单独安装它们：

pip install nexa Pillow pytesseract PyMuPDF python-docx

在激活环境并安装依赖后，使用以下命令运行脚本：

6. 运行脚本 🎉

python main.py

Processus d'utilisation

1. 指定输入目录： 在运行程序后，输入需要整理的文件夹路径，例如：

   /home/user/documents/input_files
   

2. 指定输出目录： 输入整理后文件存放的文件夹路径，或按 Enter 使用默认路径：

   /home/user/documents/organized_folder
   

3. Voir le progrès： 程序会显示文件路径加载时间和目录树，用户可以实时查看文件分析进度。
4. 文件分类和重命名： 程序会根据文件内容生成相关描述、文件夹名称和文件名，并显示在终端。
5. 完成整理： 整理完成后，用户可以在指定的输出目录查看分类后的文件。

Fonctionnalités avancées

• 静默模式： 在运行程序时添加 --silent 参数，保存所有日志到文本文件：

  python main.py --silent
  

• 干运行模式： 在运行程序时添加 --dry-run 参数，检查排序结果而不提交更改：

  python main.py --dry-run
  

• 更改模型： 用户可以通过 CLI 更改使用的 AI 模型：

  python main.py --model Llama3.2