StratoSort

🎯 StratoSort - AI-Powered Document Organization

StratoSort Logo [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Electron](https://img.shields.io/badge/Electron-26.2.1-blue.svg)](https://www.electronjs.org/) [![React](https://img.shields.io/badge/React-18.2.0-blue.svg)](https://reactjs.org/) [![Ollama](https://img.shields.io/badge/Ollama-Compatible-green.svg)](https://ollama.ai/) [![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3.4.3-blue.svg)](https://tailwindcss.com/)

Production-Ready AI File Organization System - Complete with glassmorphism UI, semantic analysis, and intelligent file management.

🚀 Overview

StratoSort is a production-ready, privacy-focused AI document organization system that intelligently categorizes and organizes your files using local AI processing. Built with modern technologies and featuring a beautiful glassmorphism interface, StratoSort provides enterprise-grade file management without compromising your privacy.

✅ Feature status

🔑 Key Benefits

✨ Current Features

🎯 Complete 5-Phase Workflow

  1. 🚀 Welcome - Introduction and quick start options
  2. ⚙️ Setup - Configure smart folders and AI settings
  3. 🔍 Discover - File selection, scanning, and automatic AI analysis
  4. 📂 Organize - Review suggestions and execute file organization
  5. ✅ Complete - Results summary and workflow completion

🧠 AI-Powered Analysis

🎨 Modern Interface

📁 Smart Folder Management

🤖 AI Models & performance

Optimized model selection

Performance notes

🚀 Quick Start

Prerequisites

Installation

  1. Clone & Install 
    git clone https://github.com/yourusername/stratosort.git
cd stratosort
npm install
  2. Setup Ollama 
    # Install Ollama (https://ollama.ai)
# Windows
winget install Ollama.Ollama
   
# macOS  
brew install ollama
   
# Linux
curl -fsSL https://ollama.ai/install.sh | sh
  3. Install Required Models 
    ollama pull llama3.2:latest
ollama pull llava:latest
# Optional (audio; currently disabled in UI)
# ollama pull dimavz/whisper-tiny:latest
  4. Start StratoSort 
    npm run dev

🧠 Using Ollama locally

Windows

Vision (images)

ollama pull llava:latest

Optional: Embeddings

ollama pull mxbai-embed-large

Optional: Whisper (tiny) for audio transcription

ollama pull dimavz/whisper-tiny:latest


- Verify:
```powershell
ollama list
curl http://127.0.0.1:11434/api/tags
ollama run llama3.2:latest -p "Say hello"

macOS

Linux

Troubleshooting

🏗️ Architecture

Modern Tech Stack

File Structure

stratosort/
├── src/
│   ├── main/                 # Electron main process
│   │   ├── analysis/         # AI analysis services
│   │   ├── services/         # Core business logic
│   │   └── simple-main.js    # Application entry point
│   ├── renderer/             # React frontend
│   │   ├── components/       # UI components
│   │   ├── App.js           # Main application
│   │   └── tailwind.css     # Styling system
│   ├── preload/             # Secure IPC bridge
│   └── shared/              # Common constants & utilities
├── assets/                  # Icons & resources
└── test/                   # Test suites

💻 Development

Available Commands

# Development
npm run dev                # Start development Electron app (dev build)
npm run start:dev          # Dev build + Electron with logging
npm run start:debug        # Dev build + Electron with inspector
npm run electron           # Build dev bundle and launch Electron
npm run build:dev          # Build renderer/main in development mode

# Build & distribution
npm run build              # Production build
npm run package            # Create distributable
npm run dist               # Build installer for current platform
npm run dist:win           # Build Windows installer (.exe)
npm run dist:mac           # Build macOS installer (.dmg)
npm run dist:linux         # Build Linux AppImage/.deb (per config)
npm run dist:all           # Build for all platforms

# Testing
npm test                   # Run Jest test suite
npm run test:quick         # Quick run (bail on first failure)
npm run test:full          # Full test suite with coverage
npm run verify             # Show test guide and available commands

# Ollama utilities
npm run setup:ollama       # Guided setup
npm run check:ollama       # Check Ollama status
npm run start:ollama       # Start Ollama service
npm run ollama:models      # Pull example model(s)
npm run ollama:serve       # Alias to 'ollama serve'

# Linting
npm run lint               # Code linting

Development Features

🧪 Testing

What’s covered

Run tests locally with npm test. Note: audio analysis tests exist for module-level behavior, but audio features are disabled in the current UI build.

🎯 Usage Workflow

Step-by-Step Process

  1. 🚀 Welcome Phase
    • Choose between “Organize Files Now” or “Setup Configuration”
    • Optional demo walkthrough (currently hidden for streamlined experience)
  2. ⚙️ Setup Phase
    • Create smart folders with custom names and paths
    • Configure AI models and performance settings
    • Set up naming conventions and organizational rules
  3. 🔍 Discover Phase
    • Select files via drag & drop, file browser, or folder scanning
    • Automatic AI content analysis begins immediately
    • Real-time progress tracking with detailed feedback
  4. 📂 Organize Phase
    • Review AI suggestions for each file
    • Edit categories, names, and destinations as needed
    • Execute batch organization with confirmation dialogs
  5. ✅ Complete Phase
    • View organized files summary
    • Access undo/redo operations
    • Return to any phase for additional organization

🛠️ Configuration

Smart Folder Setup

// Example smart folder configuration
{
  name: "Research Papers",
  path: "C:/Users/YourName/Documents/Research",
  description: "Academic papers and research documents",
  keywords: ["research", "paper", "study", "analysis"],
  semanticTags: ["academic", "scientific", "educational"]
}

AI Model Configuration

🤝 Contributing

Development Setup

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Follow the established code patterns and architecture
  4. Ensure all tests pass (npm test)
  5. Submit pull request with detailed description

Code Standards

📄 License

MIT License - Complete freedom to use, modify, and distribute.

Permissions

Requirements

🔗 Links & Resources

**🌟 StratoSort - Intelligent File Organization** *Privacy-focused • AI-powered • Production-ready* **Built with modern technologies for the modern workspace**
This site is open source. Improve this page.