Local-File-Organizer

环境要求

• Python 3.12 或更高版本
• 已安装 Conda（用于创建 conda 环境）
• 根据硬件选择 CPU 版或 GPU 版 Nexa SDK（macOS Metal 走 GPU 版）
• 已获取 Local-File-Organizer 项目代码（克隆或解压到本地）

安装与启动步骤

1. 1安装 Python

   从官网下载并安装 Python，README 推荐使用 Python 3.12 或更高版本，按操作系统说明完成安装。

2. 2创建 Conda 环境

   新建名为 local_file_organizer 的环境，并指定 Python 3.12 版本。

   conda create --name local_file_organizer python=3.12

   复制

3. 3激活环境

   切换到刚创建的环境，后续所有安装和运行都在该环境中进行。

   conda activate local_file_organizer

   复制

4. 4安装 Nexa SDK (CPU)

   CPU 版安装命令；显卡用户不要用这条，按 README 另选 Metal 版或参考 CUDA/AMD 文档。

   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

   复制

5. 5安装 Nexa SDK (Metal)

   macOS 且需要 Metal GPU 加速时改用这条命令，设置 CMAKE_ARGS 后安装。

   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

   复制

6. 6进入项目目录

   把路径替换成你实际克隆或解压 Local-File-Organizer 的目录。

   cd path/to/Local-File-Organizer

   复制

7. 7安装项目依赖

   在项目目录内根据 requirements.txt 安装所需依赖包。

   pip install -r requirements.txt

   复制

8. 8运行脚本

   依赖装完后直接执行主脚本，程序会扫描目录并用本地模型整理文件。

   python main.py

   复制

如何确认成功

执行 python main.py 后终端无报错并正常运行，整理完成后输出目录中会出现 Financial、Photos 等分类文件夹。

常见问题

注意事项

• 全部推理在本地完成，文件内容不上传云端，隐私有保障。
• Nexa SDK 支持 CPU、Metal、CUDA、AMD GPU 多种后端，安装命令不通用，务必按硬件选择。
• 模型相关问题请到 Nexa SDK 仓库反馈，不要在项目仓库重复提问。