告别文件混乱：本地AI文件分类工具零基础部署指南

Local-File-Organizer是一款基于AI技术的智能文件管理工具，所有文件处理均在本地完成，无需上传到云端，在保护用户隐私的同时实现智能文件整理。它能够自动扫描、分类和重命名电脑上的各种文件，让杂乱无章的文件变得井然有序。

功能亮点

本地AI驱动的智能分类

采用Llama3.2 3B和LLaVA-v1.6模型，通过Nexa SDK实现本地化AI处理，无需依赖云端服务，确保文件处理的私密性和安全性。

多类型文件支持

支持文本、图像、文档等多种文件类型的智能识别与分类，满足不同用户的文件管理需求。

自定义分类规则

用户可通过配置文件自定义分类规则，灵活适应个人或企业的文件管理习惯。

如何检测系统兼容性？

在开始部署前，建议先检查系统是否满足运行要求。可通过以下命令查看系统信息：

python -m platform

系统要求

• 操作系统：Windows 10/11、macOS 12+、Linux Ubuntu 18.04+
• Python版本：Python 3.12或更高版本
• 内存要求：至少8GB RAM（推荐16GB）
• 存储空间：需要2GB以上的可用磁盘空间

三步完成依赖安装

一键部署流程

1. 获取项目代码

打开终端或命令提示符，执行以下命令拉取项目代码：

git clone https://gitcode.com/gh_mirrors/lo/Local-File-Organizer

代码拉取成功后，通过以下命令切换至工作目录：

cd Local-File-Organizer

2. 配置Python环境

推荐使用Conda来管理Python环境，避免依赖冲突：

conda create --name file_organizer python=3.12 conda activate file_organizer

3. 安装核心依赖

根据硬件情况选择合适的安装方式：

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

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

安装项目依赖：

pip install -r requirements.txt

如需加速安装可添加 --no-cache-dir 参数。

高级配置

AI模型路径配置

项目使用Llama3.2 3B和LLaVA-v1.6模型，首次运行时会自动下载。请确保网络连接稳定，模型文件较大，下载需要一些时间。

自定义分类规则

核心处理逻辑：output_filter.py，用户可根据需求修改其中的规则。

效果验证

运行主程序启动智能文件整理：

python main.py

系统将开始扫描指定目录的文件，使用AI技术自动分类整理。您可以使用sample_data目录中的示例文件测试分类效果。

上图展示了工具对图像文件的分类处理能力，体现了本地文件整理的高效性。

常见问题速查

安装类型	问题	解决方案
CPU	安装速度慢	添加 --no-cache-dir 参数
CPU	依赖冲突	使用Conda环境
macOS	编译错误	确保安装Xcode命令行工具
通用	模型下载失败	检查网络连接，尝试手动下载

使用技巧

• 先从少量文件开始测试，熟悉分类规则
• 参考file_utils.py中的工具函数来扩展功能
• 大文件处理可能需要较长时间，请耐心等待
• 项目使用多进程加速，CPU核心越多处理越快