Skip to content

v2.0.0 — AI-Powered Web Application

Latest

Choose a tag to compare

@bcankara bcankara released this 08 Feb 12:24
· 33 commits to main since this release

🚀 LitOrganizer v2.0.0 — AI-Powered Web Application

Major Release: LitOrganizer has been completely redesigned from a PyQt5 desktop application to a modern Flask + Socket.IO web application with Google Gemini AI integration.

✨ Highlights

  • 🤖 Google Gemini AI Integration — AI-powered metadata extraction when DOI lookup fails
  • 🌐 Modern Web Interface — Clean, responsive UI with Tailwind CSS
  • ⚡ Real-time Updates — WebSocket-powered live progress with animated progress rings
  • 📁 Native OS Folder Picker — Select directories using your system's file dialog
  • 📚 Published in SoftwareX (Elsevier) — DOI: 10.1016/j.softx.2025.102198

➕ Added

  • Google Gemini AI Integration: AI-powered metadata extraction using Gemini Flash 2.0 as an intelligent fallback when DOI extraction fails
  • Inline Gemini AI Panel: Real-time results panel showing connection status, active queries, and extracted metadata
  • Separate AI Folder Option: Place Gemini AI-named files in AI Named Content/ instead of default Named Article/
  • Modern Web Interface: Clean, responsive UI built with Tailwind CSS
  • Real-time WebSocket Updates: Live progress tracking with circular progress rings
  • Native OS Folder Picker: System-level folder picker with quick access shortcuts
  • DOI Fallback Pipeline: Multi-stage extraction: DOI → Gemini AI → Crossref validation
  • Global Activity Panel: Persistent bottom panel with progress indicators across all pages
  • Completion Modal: Summary after processing with "Open Folder" and "View Statistics" buttons
  • Usage Guide Page: Comprehensive documentation with pipeline flowchart and API reference
  • Search Export Modal: Export results to Word/Excel with highlighted matches

🔧 Fixed

  • Backup System: Files are now properly backed up before renaming
  • Open Folder Button: Cross-platform folder opening now works correctly
  • Statistics Persistence: Processing stats survive page navigation
  • Real-time Counter Updates: Live statistics during PDF processing
  • Startup Scripts: Improved reliability and error handling for Windows/macOS/Linux launchers

🔄 Changed

  • Architecture: Complete migration from PyQt5 desktop GUI to Flask + Socket.IO web app
  • Python Requirement: Now supports Python 3.10+ (previously 3.11 only)
  • Launcher Scripts: Modernized with better dependency management

❌ Removed

  • PyQt5 Desktop GUI: Legacy desktop interface completely removed
  • Drag & Drop: Replaced with native OS folder picker
  • Heuristic Extraction: Replaced by Google Gemini AI

📥 Installation

Quick Start (Recommended)

  1. Download and extract LitOrganizer-v2.0.0.zip (Windows) or LitOrganizer-v2.0.0.tar.gz (macOS/Linux)
  2. Run the launcher script:
    • Windows: Double-click start_litorganizer.bat
    • macOS: Double-click Start LitOrganizer.command or run ./start_litorganizer.sh
    • Linux: Run ./start_litorganizer.sh
  3. Open http://localhost:5000 in your browser

Requirements

  • Python 3.10 or higher
  • Internet connection (for API metadata retrieval)

📖 Documentation

See the User Guide for detailed instructions on:

  • Naming pipeline and confidence levels
  • Gemini AI setup and configuration
  • Keyword search with regex examples
  • API reference and configuration

📚 Citation

If you use LitOrganizer in your research, please cite:

Şahin, A., Kara, B. C., & Dirsehan, T. (2025). LitOrganizer: Automating the process of data extraction and organization for scientific literature reviews. SoftwareX, 30, 102198. https://doi.org/10.1016/j.softx.2025.102198