Laya sorts files into meaningful folders using a lightweight local decision engine. Preview changes before anything moves.
Test Laya with your actual file names or drop any sample below. Watch the decision pass evaluate context and route with precision.
File organization should give peace of mind, not panic. Laya is built with defensive defaults so you never lose work.
Run with --dry-run to simulate every destination path before touching the disk. Review the full change manifest upfront.
If report.pdf already exists at the destination, Laya safely appends report_dup_1.pdf rather than silently overwriting.
Any file scoring below 50% confidence automatically routes to Uncertain/ instead of making a flawed guess.
Your Downloads folder contains invoices, contracts, personal photos, and sensitive data. Laya runs entirely on your CPU with no remote API dependencies.
Works on macOS, Linux, and Windows with Python 3.10+.
Grab the repo or install via pip to get the CLI binary.
git clone https://github...
Test what Laya would do without moving a single file.
python3 laya_organizer.py ~/Downloads --dry-run
Organize in-place or route to a dedicated clean folder.
python3 laya_organizer.py ~/Downloads -o ~/Organized
| Flag / Argument | Type | Description | Example |
|---|---|---|---|
--dry-run |
Boolean Flag | Simulate organization paths without moving or creating files on disk | python3 laya_organizer.py ~/Downloads --dry-run |
-o, --output |
Directory Path | Target directory for organized folders. Preserves original directory if specified | python3 laya_organizer.py ~/Downloads -o ~/Organized |
--confidence |
Float (0.0 - 1.0) | Minimum certainty threshold (default 0.50). Predictions below this route to Uncertain/ | python3 laya_organizer.py ~/Downloads --confidence 0.75 |
--check |
Verification Flag | Runs the embedded test suite and self-check diagnostics on the decision router | python3 laya_organizer.py --check |
Never. Laya only performs safe directory moves. Temporary scrap and cache files are routed to Junk_Candidates/ so you can review them before deleting anything manually.
Laya includes collision detection. If report.pdf already exists in the destination folder, Laya renames the incoming file to report_dup_1.pdf to prevent data loss.
No. Laya is powered by a lightweight local decision engine that executes directly on your CPU. It transmits zero bytes to any server and works seamlessly in airplane mode.
Yes. Use the -o / --output <path> argument to route organized categories to a separate directory, or use --dry-run to preview everything in your terminal first.