OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Local & Self-hosted AI

Local File Organizer

Local File Organizer is a Python application that uses the Nexa SDK with Llama 3.2 3B and LLaVA v1.6 to analyze local text and image files and organize them into a new directory structure.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Local File Organizer — OpenViST project profile in Local & Self-hosted AI.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when you want AI-assisted sorting of a local directory and prefer the documented on-device workflow over an AI API.

Who it is for

  • People who want to organize local collections of documents and images using on-device AI.
  • Users comfortable installing and running a Python project on their own computer.

Documented uses

  • Sort text documents into folders based on their content.
  • Categorize images using visual-language model analysis.
  • Create descriptive metadata, folder names, and filenames for organized files.
Before you choose

Requirements & limits

  • The documented stack is Python 3.12, Conda, the Nexa SDK, and project dependencies.
  • The README lists Windows, macOS, and Linux; SDK installation instructions vary by CPU or GPU setup.
  • Model files or paths may need to be downloaded or configured.
  • Tesseract OCR is a separate prerequisite for pytesseract support, and PyMuPDF is used to read PDFs.
  • Processing time depends on the number and size of files.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Set up Local File Organizer on your device

Prepare the Python environment, Nexa SDK, and project dependencies for Local File Organizer.

Before you start

  • Python 3.12 or later
  • Anaconda or Miniconda
  • Git, or download the repository as a ZIP file
  • A Windows, macOS, or Linux system

Steps

  1. Install Python 3.12 or later, then clone the repository with the command below or download and extract its ZIP archive.

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

  2. Create and activate the Conda environment: conda create --name local_file_organizer python=3.12 followed by conda activate local_file_organizer.

  3. Install the Nexa SDK using the documented CPU installation command, or the Metal GPU command for macOS.

  4. From the project directory, install dependencies with the command below.

    Documented command
    pip install -r requirements.txt

Expected outcome

The project environment and required dependencies are installed, ready for the documented script-running stage.

Guide limitations

  • The README does not give CUDA or AMD GPU installation commands; it links to Nexa SDK installation guidance for those options.
  • Model access and setup may be required, including downloading model files or configuring paths.
  • pytesseract requires Tesseract OCR to be installed separately.
  • This setup procedure does not confirm that installation succeeds on a particular system.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
14 October 2026
Original website title
QiuYannnn/Local-File-Organizer · Official homepage title · retained in its source language
How we review sourcesSuggest a correction