comicsnowdev/comics-now repository overview

⁠Comics Now! 💥📚

The modern, self-hosted comic book library server, smart reader, and AI-augmented cataloging platform.

https://comicsnow.github.io/⁠

⁠⚡ Key Features

• 🧠 Smart Guided View: Automatically detects panels and dialogue bubbles using deep learning neural networks for an immersive panel-by-panel reading experience.
• 🤖 Google Gemini AI Vision: Multimodal visual cover recognition identifies series, issue numbers, publishers, and release years directly from cover art when standard scraping fails.
• 🖼️ Page Preview Grid & WebP Cache: Visual thumbnail navigator with on-the-fly full-resolution WebP transcoding and LRU disk caching.
• 📱 Resumable Offline PWA: Install Comics Now! to your phone, tablet, or desktop. Resumable downloads via HTTP Range headers and native Android Background Fetch.
• 🏷️ Multi-Source Tagging & Organization: Built-in enrichment engine querying ComicVine, Metron, GCD, Goodreads, Amazon, Google Books, and more. Customizable token naming rules and folder hierarchy templates.
• 🔄 Real-Time Cross-Device Sync: Reading progress, status, and bookmarks sync seamlessly across your phone, tablet, and PC.
• 🔌 AI Model Context Protocol (MCP): Native Python MCP server allowing Claude, Cursor, and Gemini to curate reading lists, inspect cover art, and query your collection.
• 🛡️ Cloudflare Zero Trust Ready: Full integration with Cloudflare Access JWT authentication and granular per-user permissions.
• 🐳 Multi-Architecture: Native pre-built images for both linux/amd64 (x86_64 PC/Server) and linux/arm64 (Raspberry Pi, Apple Silicon, ARM VPS).

⁠🚀 Quick Start

⁠Docker CLI

docker run -d \
  --name comics-now \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -v /path/to/your/comics:/comics:ro \
  --restart unless-stopped \
  comicsnowdev/comics-now:latest

Open http://localhost:3000⁠ in your browser!

⁠Docker Compose

Save as docker-compose.yml:

services:
  comics-now:
    image: comicsnowdev/comics-now:latest
    container_name: comics-now
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DATA_DIR=/app/data
      - PORT=3000
    volumes:
      - ./data:/app/data
      - /path/to/your/comics:/comics:ro
    restart: unless-stopped

Start the container:

docker compose up -d

⁠📖 Links & Documentation

https://comicsnow.github.io/⁠

• GitHub Repository: https://github.com/ComicsNow/comics-now⁠
• Complete Wiki & Admin Manual: https://github.com/ComicsNow/comics-now/blob/main/docs/WIKI.md⁠
• Issue Tracker & Feature Requests: https://github.com/ComicsNow/comics-now/issues⁠