# qiuyannnn/local-file-organizer

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/qiuyannnn-local-file-organizer).**

3,132 stars · 299 forks · Python · mit

## Links

- GitHub: https://github.com/QiuYannnn/Local-File-Organizer
- awesome-repositories: https://awesome-repositories.com/repository/qiuyannnn-local-file-organizer.md

## Topics

`file-organizer` `llama3` `llm` `on-device-ai` `vlm`

## Description

Local-File-Organizer is a local-first file classification system that uses on-device machine learning models to categorize documents and media into structured directories. It functions as an automated file classifier and asset manager that leverages local inference to sort files based on content, meaning, and metadata.

The project emphasizes privacy by performing all data processing and analysis on the local device, eliminating the need to send sensitive files to external cloud services. It utilizes local models to analyze text and image content to generate descriptive filenames and thematic folder hierarchies.

Beyond AI-driven organization, the system includes rule-based sorting utilities for grouping files by extension or chronological timestamps. It also provides a simulation feature that allows users to preview resulting directory structure changes before applying them to the filesystem.

## Tags

### Business & Productivity Software

- [Local File Organizers](https://awesome-repositories.com/f/business-productivity-software/local-file-organizers.md) — Automatically organizes local documents and media into structured directories using content, metadata, and file types.

### Artificial Intelligence & ML

- [Local On-Device AI](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-application-frameworks/local-on-device-ai.md) — Implements a privacy-focused system that runs AI inference locally to manage and categorize assets.
- [On-Device Inference](https://awesome-repositories.com/f/artificial-intelligence-ml/inference-clients/on-device-inference.md) — Leverages on-device model inference to group and sort files without transmitting data to external servers.

### Content Management & Publishing

- [Automated File Organizers](https://awesome-repositories.com/f/content-management-publishing/media-management/file-management-systems/automated-file-organizers.md) — Automatically organizes documents and media into structured directories using metadata and content analysis. ([source](https://github.com/QiuYannnn/Local-File-Organizer/blob/main/main.py))

### Data & Databases

- [Thematic Categorization](https://awesome-repositories.com/f/data-databases/text-processing-utilities/text-processing-tools/selective-text-processors/ai-text-transformers/thematic-categorization.md) — Analyzes text content to generate summaries and thematic categories for automatic file organization. ([source](https://github.com/QiuYannnn/Local-File-Organizer/blob/main/text_data_processing.py))
- [Chronological Archives](https://awesome-repositories.com/f/data-databases/digital-archives/chronological-archives.md) — Groups files into hierarchical structures based on creation or modification dates to maintain chronological archives.

### Development Tools & Productivity

- [Categorization Hierarchies](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/workflow-productivity-enhancers/developer-productivity-utilities/file-management-utilities/bulk-file-renamers/ai-powered-renamers/categorization-hierarchies.md) — Uses local ML models to analyze file contents and automatically generate descriptive folder hierarchies.
- [Structural Change Previews](https://awesome-repositories.com/f/development-tools-productivity/structural-diff-utilities/structural-change-previews.md) — Visualizes intended directory structure changes and file moves as a preview before applying them to the filesystem.

### Networking & Communication

- [Local File Content Extraction](https://awesome-repositories.com/f/networking-communication/email-address-validators/email-content-parsing/ai-powered-content-extraction/document-content-extraction/local-file-content-extraction.md) — Extracts summaries and descriptions from local text and image files using on-device AI models. ([source](https://github.com/QiuYannnn/Local-File-Organizer#readme))

### Security & Cryptography

- [Local Data Processing](https://awesome-repositories.com/f/security-cryptography/privacy-data-protection/local-only-data-processing/local-data-processing.md) — Ensures all data processing and analysis occurs exclusively on the local device to maintain privacy. ([source](https://github.com/QiuYannnn/Local-File-Organizer/blob/main/README.md))
- [Private Data Processing Suites](https://awesome-repositories.com/f/security-cryptography/privacy-data-protection/local-only-data-processing/private-data-processing-suites.md) — Performs all file analysis and model inference entirely on the local device to ensure data privacy.

### Part of an Awesome List

- [Date-Based File Organizers](https://awesome-repositories.com/f/awesome-lists/devtools/calendars-and-dates/date-based-file-organizers.md) — Arranges files into folders based on creation and modification timestamps for chronological archiving. ([source](https://github.com/QiuYannnn/Local-File-Organizer/blob/main/main.py))