Skip to content

Releases

v0.1.0 — Initial Release

Choose a tag to compare

@ElXprogramming ElXprogramming released this 02 Nov 17:56

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:8765 for 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 install command to run persistently in the background on boot/login via Linux systemd.
  • 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