Repository navigation
Releases
Releases · ElXprogramming/neurosort
v0.1.0 — Initial Release
NeuroSort v0.1.0 — Initial Release 🧠📁
We are excited to announce the initial release of NeuroSort, a modern, local-first, safe, and intelligent automatic file management daemon and CLI.
🌟 Key Highlights
- Local-First AI Engine: Native integration with Ollama (
llama3.2,phi3.5) for semantic classification with zero cloud data transmission. - Future Sight File System Explorer: Embedded local web interface at
http://127.0.0.1:8765for read-only preview and risk-free file inspection before moving. - Zero-Data-Loss Safe Executor: Atomic file moves (
shutil.move), collision resolution (_v1,_v2), and strict path traversal protection. - ACID SQLite Audit Ledger: Transaction logging in WAL mode with streaming SHA-256 chunk hashing and instant rollback (
neurosort undo,neurosort undo --all). - Debounced Watcher Daemon: Watchdog file system monitoring with 2-stage stabilization check (spaced 2s apart to ensure complete write completion, ignoring
.crdownload,.tmp,.*). - 24/7 Background Service: Native
neurosort service installcommand to run persistently in the background on boot/login via Linuxsystemd. - Rich Interactive CLI: Progress bars, formatted diagnostic tables, dry-run scan simulation.
📦 Installation
git clone https://github.com/ElXprogramming/neurosort.git
cd neurosort
python3 -m venv .venv
source .venv/bin/activate # or source .venv/bin/activate.fish
pip install -e .🚀 Quick Start
# Initialize configuration
neurosort init
# Preview organization without moving files
neurosort scan ~/Downloads --dry-run
# Launch local web GUI
neurosort ui
# Enable 24/7 background automation
neurosort service install