Skip to content

Calibre Bookwarden v1.3.0 — The Sovereign Calibre Guardian

Latest

Choose a tag to compare

@felixapel felixapel released this 08 Sep 08:14
· 2 commits to main since this release

🛡️ Calibre Bookwarden v1.3.0 — The Sovereign Calibre Guardian

"The book file is the ground truth. LLMs are witnesses."

We are thrilled to announce Calibre Bookwarden v1.3.0, the initial production-ready milestone of the next-generation autonomous library auditor and cover curator for Calibre ecosystems.


🌟 Key Highlights & Innovations

  • 📖 Content-Grounded Forensic Metadata Verification:

    • Treats the physical book payload (EPUB, PDF, MOBI, CBZ, AZW3) as the unassailable ground truth.
    • Multi-tiered AI extraction leveraging Google Gemini 2.5 and OpenAI GPT-4o with rigorous confidence thresholds.
    • Fully deterministic offline heuristics when air-gapped or disconnected from external APIs.
  • 🎨 Cover Forensics & CQS (Cover Quality Score):

    • Vectorized Shannon entropy and Laplacian variance sharpness algorithms.
    • Instant detection of spurious, solid-color, or generic vendor placeholder covers.
    • Cover Deck UI: Interactive swipeable interface to audit, approve, or hot-swap covers with sub-50ms HTMX reactivity.
  • 💎 State-of-the-Art 2026 Web UI:

    • Dark-mode native, ultra-responsive design crafted with modern tokens (Inter, JetBrains Mono, glassmorphism).
    • Real-time audit visualizer, live status streaming, and instant remediation buttons.
    • Backed by a hermetic 17/17 Playwright E2E contract test suite.
  • 📦 Native Unraid Community Applications Integration:

    • Official Unraid XML template maintained in felixapel/unraid-templates.
    • High-resolution 512x512 squircle icon designed for Unraid dashboards.
    • Automatic thumbnail cache purge & SIGHUP hot-reload for calibre-web-automated (CWA).
  • 🔒 Zero-Trust Hardened Architecture:

    • Certificate A Quality Gates: Strict PostgreSQL least-privilege role separation (migrator, writer, verifier, app).
    • Trivy-certified zero-vulnerability container stack.
    • Read-only container root filesystems with dropped capabilities and no-new-privileges.

🚀 Getting Started

🐳 Docker Compose Quickstart

git clone https://github.com/felixapel/calibre-bookwarden.git
cd calibre-bookwarden
cp .env.example .env
docker compose up -d

Access the dashboard at http://localhost:8080.

🖥️ Unraid Community Applications

  1. In your Unraid WebGUI, navigate to Apps -> Settings.
  2. Add the template repository:
    https://github.com/felixapel/unraid-templates
  3. Search for Calibre Bookwarden and click Install.

📦 Artifacts & Packages


💖 Support & Sponsorships

If Calibre Bookwarden helps keep your digital library clean, pristine, and secure, consider supporting its continued development: