Releases: GabrieleTrovato01/KoreShelf
KoreShelf v2.0.3 - Multilingual Backend & Performance Update.
#🇮🇹 Versione Italiana
KoreShelf v2.0.3 - Aggiornamento Backend Multilingue e Performance
Siamo entusiasti di rilasciare la versione 2.0.3, un aggiornamento che rende KoreShelf un'applicazione globale e ancora più performante!
Novità principali:
Backend Internazionalizzato (i18n): Ora l'intero server rispetta la lingua impostata. Tutti i log del terminale, i messaggi di errore e le esportazioni in formato Markdown (.md) sono ora disponibili sia in italiano che in inglese, rendendo il sistema perfetto per qualsiasi utente.
Gestione Errori Evoluta: Implementato uno scudo anti-crash globale che gestisce elegantemente i file EPUB malformati.
#🇺🇸 English Version
KoreShelf v2.0.3 - Multilingual Backend & Performance Update
We are thrilled to release v2.0.3, making KoreShelf truly global and more performant than ever!
Key Changes:
Full Backend i18n: The server is now fully internationalized. All terminal logs, error messages, and Markdown (.md) knowledge base exports are now localized in both English and Italian, providing a consistent experience for all users.
Enhanced Error Handling: Implemented a global anti-crash shield to gracefully handle malformed EPUB files.
v2.0.2 - The "LoreKeeper" Evolution: Welcome to KoreShelf! 📚✨
Complete Rebranding: All UI elements, system messages, and documentation have been updated from LoreKeeper to KoreShelf.
Package & Build Optimization: Updated package.json and build scripts to reflect the new architecture.
Markdown AI-Bridge Refinement: Enhanced the core feature that allows you to extract clean Markdown (.md) from your EPUBs/PDFs, ready to be digested by Claude, ChatGPT, or your Obsidian vault.
General UI/UX Polish: Minor glassmorphism tweaks and responsive fixes for the bottom action bar.
LoreKeeper v2.0.1 - Quality of Life Update
Aggiunto controllo automatico degli aggiornamenti con UI Glassmorphism.
Il server ora apre automaticamente il browser di sistema all'avvio.
Added automatic check for update with UI Glassmorphism.
Server now opens automatically the system browser on startup.
LoreKeeper 2.0.0 - Multi-Platform & Docker Release
🇬🇧 English
🚀 LoreKeeper 2.0.0: The Multi-Platform Release!
This is the biggest update to LoreKeeper yet. We have transformed the project from a purely containerized environment into a standalone desktop application, making it accessible to everyone without any complex setups.
✨ New Features & Updates
- Standalone Executables (Windows, Linux, macOS Apple Silicon): LoreKeeper is now a portable app. No need to install Node.js or configure servers. Just download the archive, extract it, and run the file to immediately enter your 3D library.
- Global Export for AI (Markdown): We have optimized text extraction. You can now export an entire book into a single, clean, and structured
.mdfile for a complete analysis of the whole book. It's the perfect format for feeding your local LLMs or importing into Obsidian and Notion. - Smart Docker Shutdown: Fixed a critical bug in self-hosting. We updated the
docker-compose.ymlrestart policy toon-failure. Now, clicking the shutdown button from the UI will cleanly exit the container without it looping into a restart. - New Documentation: The README has been completely rewritten to clearly separate the easy installation (Portable App) from the advanced developer setup (Docker).
⚠️ Important First-Launch Instructions
- Windows Users: Since this is an open-source software without a paid digital signature, SmartScreen might block the first launch. Click "More info" and then "Run anyway".
- macOS Users (M1, M2, M3 Chips): Due to Apple's "Quarantine" for unsigned apps, you must unlock the executable. Open your terminal in the downloaded folder and run these two commands before double-clicking:
chmod +x lorekeeper-macos-arm
xattr -cr lorekeeper-macos-arm - Intel Mac Users: Pre-built binaries for the older Intel architecture are not included in this release. Please use the Docker version.
🇮🇹 Italiano
🚀 LoreKeeper 2.0.0: La Release Multipiattaforma!
Questo è il più grande aggiornamento di LoreKeeper ad oggi. Abbiamo trasformato il progetto da un ambiente puramente basato su container in un'applicazione desktop autonoma, rendendola accessibile a chiunque senza bisogno di configurazioni complesse.
✨ Novità e Funzionalità
- Eseguibili Standalone (Windows, Linux, macOS Apple Silicon): LoreKeeper è ora un'app portatile. Non serve installare Node.js o configurare server. Basta scaricare l'archivio, estrarlo e avviare il file per entrare subito nella tua libreria 3D.
- Esportazione Globale per IA (Markdown): Abbiamo ottimizzato l'estrazione del testo. Ora puoi esportare un intero libro in un singolo file
.mdpulito e strutturato per un'analisi globale di tutta l'opera. È il formato perfetto per alimentare i tuoi LLM locali o per l'importazione su Obsidian e Notion. - Spegnimento Docker Intelligente: Risolto un bug critico nel self-hosting. Abbiamo aggiornato la policy del
docker-compose.ymlsuon-failure. Ora, cliccando il pulsante di spegnimento dall'interfaccia, il container si chiuderà in modo pulito senza riavviarsi in loop. - Nuova Documentazione: Il README è stato completamente riscritto per separare nettamente l'installazione semplificata (App Portatile) da quella avanzata per sviluppatori (Docker).
⚠️ Istruzioni Importanti per il Primo Avvio
- Utenti Windows: Essendo un software open-source senza firma digitale a pagamento, SmartScreen potrebbe bloccare il primo avvio. Cliccate su "Ulteriori informazioni" e poi su "Esegui comunque".
- Utenti macOS (Chip M1, M2, M3): A causa della "Quarantena" di Apple per le app non firmate, dovete sbloccare l'eseguibile aprendo il terminale nella cartella scaricata e lanciando questi due comandi prima di fare doppio clic:
chmod +x lorekeeper-macos-arm
xattr -cr lorekeeper-macos-arm - Utenti Mac Intel: I binari precompilati per la vecchia architettura Intel non sono inclusi in questa release. Vi invitiamo a utilizzare la versione Docker.
LoreKeeper v1.3.0 - Portable Edition for Windows
🚀 LoreKeeper v1.3.0 - Portable Edition
Siamo entusiasti di annunciare il rilascio ufficiale di LoreKeeper v1.3.0! Questa versione segna un passo fondamentale per il progetto: da oggi LoreKeeper è un software completamente portatile.
🌟 Cosa c'è di nuovo?
- Standalone Windows Executable: Non è più necessario installare Node.js, Docker o gestire complesse configurazioni di ambiente. Abbiamo implementato un sistema di packaging avanzato che ti permette di eseguire LoreKeeper con un semplice doppio clic.
- Gestione Dinamica dei Dati: Risolti definitivamente i conflitti di sincronizzazione tra file di sistema e libreria. Ora i tuoi eBook, copertine e il database vengono gestiti in tempo reale sul disco, garantendo che ciò che vedi nell'applicazione sia sempre sincronizzato con i file fisici nella tua cartella.
- Architettura Ottimizzata: Grazie a un nuovo motore di compilazione, l'eseguibile è più leggero, veloce all'avvio e isolato da qualsiasi dipendenza esterna, rendendolo perfetto per essere tenuto su una chiavetta USB o in qualsiasi cartella del tuo PC.
- Pulizia Automatica: Il processo di build ora include un filtro intelligente che previene l'inclusione accidentale di dati di sviluppo nel pacchetto finale, assicurando un'esperienza "out-of-the-box" pulita e senza residui di vecchie sessioni.
🛠 Come iniziare
- Scarica il file
LoreKeeper-v1.3.0-win.ziptra gli asset qui sotto. - Estrai il contenuto in una cartella a tua scelta.
- Avvia
lorekeeper-app.exe. - LoreKeeper si occuperà di creare automaticamente l'ambiente di lavoro (cartelle di upload e database) al primo avvio.
💡 Note per l'utente
Questa versione è pensata per garantirti la massima libertà. I tuoi dati personali (libri e configurazioni) verranno creati nella directory di lavoro, rendendo il backup semplice quanto copiare la cartella principale del programma.
Un ringraziamento speciale a tutti coloro che hanno contribuito a testare questa release e a segnalare i bug di isolamento dei file!
Buona lettura e buona organizzazione della conoscenza con LoreKeeper! 📚✨
🚀 LoreKeeper v1.3.0 - Portable Edition
We are thrilled to announce the official release of LoreKeeper v1.3.0! This version marks a fundamental milestone for the project: from today, LoreKeeper is a fully portable software.
🌟 What's New?
- Standalone Windows Executable: No more need to install Node.js, Docker, or manage complex environment configurations. We have implemented an advanced packaging system that allows you to run LoreKeeper with a simple double-click.
- Dynamic Data Management: We have permanently resolved synchronization conflicts between system files and the library. Now, your eBooks, covers, and the database are managed in real-time on the disk, ensuring that what you see in the application is always perfectly synced with the physical files in your folder.
- Optimized Architecture: Thanks to a new build engine, the executable is lighter, faster to launch, and isolated from any external dependencies, making it perfect for keeping on a USB drive or in any folder on your PC.
- Automatic Cleanup: The build process now includes an intelligent filter that prevents the accidental inclusion of development data in the final package, ensuring a clean "out-of-the-box" experience without any leftovers from previous sessions.
🛠 How to Get Started
- Download the
LoreKeeper-v1.3.0-win.zipfile from the assets below. - Extract the contents into a folder of your choice.
- Launch
lorekeeper-app.exe. - LoreKeeper will automatically take care of creating the working environment (upload folders and database) upon the first launch.
💡 User Notes
This version is designed to guarantee you maximum freedom. Your personal data (books and configurations) will be created in the working directory, making backup as simple as copying the main program folder.
A special thanks to everyone who helped test this release and report file isolation bugs!
Happy reading and happy knowledge organizing with LoreKeeper! 📚✨
🚀 LoreKeeper v1.1.0 - L'Era Internazionale
EN
🎉 What's New
Complete Multilingual Support (i18n): LoreKeeper now speaks both Italian and English! The interface, menus, and modals update instantly.
New Splash Screen: Added an elegant loading screen during the startup of the 3D library.
🐛 Bug Fixes
Critical Docker Fix (EXDEV): Resolved a bug that prevented the correct uploading of .epub files when using Docker with persistent volumes. Uploads now work perfectly.
Optimized Loading: Improved asynchronous data loading to eliminate initial lag.
IT
🎉 Novità
Multilingua Completo (i18n): LoreKeeper ora parla sia Italiano che Inglese! Interfaccia, menu e modali si aggiornano istantaneamente.
Nuovo Splash Screen: Aggiunta una schermata di caricamento elegante durante l'avvio della libreria 3D.
🐛 Bug Fixes
Fix Critico Docker (EXDEV): Risolto un bug che impediva il corretto caricamento (upload) dei file .epub quando si utilizzava Docker con volumi persistenti. L'upload ora funziona perfettamente.
Ottimizzato il caricamento asincrono dei dati per eliminare i lag iniziali.
LoreKeeper 1.0: The Knowledge Guardian Release
📚 LoreKeeper v1.0.0 - The Knowledge Guardian Release
(Scroll down for the Italian version 🇮🇹)
Welcome to the first official release of LoreKeeper, the 3D digital library designed to transform the way you organize, browse, and analyze your books.
This version marks a fundamental shift in our architecture: we have removed the heavy local AI integrations (which were slow and resource-hungry) to transform LoreKeeper into the ultimate data preparation tool for modern Cloud AIs.
🌟 Main Features
- Immersive 3D Environment: Explore your collection in a fluid graphical environment built with Three.js. Navigate through shelves, move books around, and enjoy your library like never before.
- 🤖 Killer Feature: Export for AI: Every book can now be instantly transformed into a clean textual "Knowledge Base". With a single click, LoreKeeper extracts the text from the EPUB, strips away unnecessary code, and generates a
.txtfile optimized to be fed to ChatGPT, Claude, or Gemini. - Smart Management: Upload your EPUBs and let LoreKeeper do the dirty work. The system automatically extracts metadata and covers, with smart fallback algorithms using Google Books and Apple Books.
- Dynamic Organization: Create custom shelves, rename them, and move books with an intuitive and persistent drag-and-drop interface.
- 100% Privacy: Everything you upload stays on your computer. LoreKeeper runs entirely locally via Docker.
🚀 Technical Optimizations (vs dev versions)
- Digital Diet: We completely removed Ollama and Langchain from the app's core. The result? The Docker image is incredibly lighter, and RAM usage has dropped by 90%.
- Lightning Fast: The Node.js server now responds instantly, ensuring extreme fluidity during 3D navigation.
- Docker-Ready: Refined configuration files for an immediate, one-command deployment (
docker-compose up -d --build).
🛠 How to use the AI feature
- Select a book from the 3D carousel.
- Click on "🤖 Esporta per IA" (Export for AI).
- Drop the downloaded
.txtfile into your favorite AI chat. - Ask complex questions about the plot, request summaries, or stylistic analysis: the AI will now have the complete and clean context of the book!
📦 Quick Start
git clone https://github.com/GabrieleTrovato01/LoreKeeper.git
cd LoreKeeper
docker-compose up -d --buildThen open http://localhost:3000 and start building your sanctuary of knowledge.
🇮🇹 Versione Italiana
Benvenuti alla prima release ufficiale di LoreKeeper, la libreria digitale 3D progettata per trasformare il modo in cui organizzi, sfogli e analizzi i tuoi libri.
Questa versione segna un cambio di rotta fondamentale: abbiamo rimosso le pesanti integrazioni IA locali (lente e voraci di risorse) per trasformare LoreKeeper nello strumento definitivo di preparazione dei dati per l'IA moderna in cloud.
🌟 Novità Principali
- Ambiente 3D Immersivo: Esplora la tua collezione in un ambiente grafico fluido sviluppato con Three.js. Naviga tra le mensole, sposta i libri e goditi la tua libreria come mai prima d'ora.
- 🤖 Feature Killer: Esporta per IA: Ogni libro può ora essere trasformato istantaneamente in una "Knowledge Base" testuale pulita. Cliccando un tasto, LoreKeeper estrae il testo dall'EPUB, lo ripulisce dal codice superfluo e genera un file
.txtottimizzato per essere dato in pasto a ChatGPT, Claude o Gemini. - Gestione Intelligente: Carica i tuoi EPUB e lascia che LoreKeeper faccia il lavoro sporco. Il sistema estrae automaticamente metadati e copertine utilizzando algoritmi di fallback su Google Books e Apple Books.
- Organizzazione Dinamica: Crea mensole personalizzate, rinominale e sposta i libri con un'interfaccia drag-and-drop intuitiva e persistente.
- Privacy al 100%: Tutto quello che carichi rimane sul tuo computer. LoreKeeper gira interamente in locale tramite Docker.
🚀 Ottimizzazioni Tecniche (rispetto alle versioni dev)
- Dieta Digitale: Abbiamo rimosso Ollama e Langchain dal core dell'app. Risultato? L'immagine Docker è infinitamente più leggera e l'utilizzo della RAM è calato del 90%.
- Velocità di Esecuzione: Il server Node.js ora risponde istantaneamente, garantendo una fluidità estrema durante la navigazione 3D.
- Docker-Ready: File di configurazione rifiniti per un deploy immediato con un solo comando (
docker-compose up -d --build).
🛠 Come usare la funzione AI
- Seleziona un libro dal carosello 3D.
- Clicca su "🤖 Esporta per IA".
- Carica il file ottenuto nella tua chat IA preferita.
- Fai domande complesse sulla trama, chiedi riassunti o analisi stilistiche: l'IA avrà il contesto completo e pulito del libro.
📦 Installazione rapida
git clone https://github.com/GabrieleTrovato01/LoreKeeper.git
cd LoreKeeper
docker-compose up -d --buildPoi vai su http://localhost:3000 e inizia a costruire il tuo santuario del sapere.
Creato con passione da Gabriele Trovato. LoreKeeper è qui per custodire le tue storie e prepararle per il futuro della conoscenza.