🧠 Folder Intelligence (Project Phoenix)

"Your digital life is chaos. Folder Intelligence brings order."

We have consolidated our 5-stage pipeline into a Single Universal Tool that works on any directory.

git clone https://github.com/SGajjar24/folder-intelligence.git
cd folder-intelligence
pip install -r requirements.txt
# Ensure Tesseract OCR is installed on your system!

By default, it runs in Dry Run mode. It scans, OCRs, and proposes changes without touching files.

python universal_cli.py "C:\Users\You\Downloads"

Satisfied with the plan? Apply the changes:

python universal_cli.py "C:\Users\You\Downloads" --execute

Unlike simple organizers, we don't just look at filenames. We look inside files.

graph TD
    A[Start: Scan File] --> B{Is it Media?}
    B -- Yes (mp3/mp4) --> C[Category: Evidence_Media]
    B -- No --> D{Is it Text PDF?}
    D -- Yes --> E[Extract Text]
    D -- No (Image/Scan) --> F[Run Tesseract OCR]
    F --> E
    E --> G{Find Date?}
    G -- Found in Text --> H[Use Content Date]
    G -- Not Found --> I[Use System Date]
    H --> J[Match Keywords]
    I --> J
    J --> K[Determine Category]
    K --> L[Move & Rename File]

Customize the logic to fit your needs (e.g., Music, Work, Legal). The tool loads default_config.json by default, but you can pass any config file with --config.

{
    "categories": {
        "01_Bills": ["invoice", "receipt", "paid"],
        "02_Contracts": ["agreement", "signed", "nda"],
        "99_Unsorted": []
    },
    "blocked_dirs": ["C:\\Windows", "C:\\Program Files"]
}

python universal_cli.py "C:\My\Music" --config "music_config.json"

This project ships with formal governance documentation:

See SOP.md for full enterprise use cases.

Swetang Gajjar

This project is licensed under the MIT License — see LICENSE for details.

⭐ If this tool saved you time, give it a star!
Built with precision. Ships with governance.