monbooru

README

Monbooru

Your own self-hosted, lightweight and fast booru.
Designed for organizing your local media collection, including AI-generated images (Stable Diffusion, ComfyUI, A1111/Forge). Completely offline by design. Supports ONNX models for local auto-tagging of your collection (WD14, JoyTag...).

---

Features

• Tag-based gallery with folder tree, favorites, saved searches, collections, related-image suggestions, and rating tags (general / sensitive / questionable / explicit) with a SFW ceiling
• Stable Diffusion metadata from A1111/Forge and ComfyUI: prompts, models, seeds, full workflows
• Local ONNX auto-tagging (WD14 SwinV2, JoyTag, Camie v2, or any compatible model) on CPU or GPU
• Images, video, animated GIFs, plus CBZ/ZIP archives browsed as a single object with a built-in manga reader; animated hover previews on the grid
• Search with wildcards, OR, exclusions, plus filters on folder, date, size, dimensions, category, generation recipe, and more
• Tag management: merge duplicates, create aliases, implications, custom categories
• Image relations: declared duplicates, alternates, version chains, derivatives; plus near-duplicate detection
• Batch operations on a selection or a whole search: delete, move, add/remove tags, auto-tag
• File watcher that catches new, moved, and deleted files within seconds; multi-file browser upload; SHA-256 dedup so the same file under two paths is one image
• Inbox workflow : new images land in the inbox for review
• Multiple galleries in one instance, each with its own filesystem and database; per-gallery export/import; import data from supported booru applications
• REST API for third-party integrations
• Companion downloader (monloader) imports images and tags from supported boorus and galleries to monbooru.
• Optional password login

---

Related applications

Monbooru is a self-hosted offline library. Optional companions applications can be used for online features :

flowchart LR
    web["- Any booru or gallery supported by gallery-dl<br/>- Direct image URL"]
    sender["<b>monsender</b><br/>browser extension"]
    loader["<b>monloader</b><br/>downloader"]
    booru(["<b>monbooru</b><br/>Your self-hosted booru"])

    web -->|browse| sender
    sender -->|REST API| loader
    web -.->|paste URL| loader
    loader -->|REST API| booru

    classDef hub  fill:#9d2235,stroke:#ef8f99,stroke-width:3px,color:#ffffff;
    classDef tool fill:#1a1818,stroke:#9d2235,stroke-width:1.5px,color:#e8e4e2;
    classDef src  fill:#1a1818,stroke:#a09898,stroke-width:1px,color:#a09898;

    class booru hub;
    class sender,loader tool;
    class web src;

• monsender : browser extension; sends the URL of the page you're currently browsing to monloader.
• monloader : downloader; fetches files and per-post metadata (via gallery-dl) and pushes them into a monbooru gallery over the REST API.
• monbooru : this application; organizes, tags, and serves your collection.

---

Quick start (Docker)

Edit the volume paths in docker/docker-compose.yml, then docker compose up -d. The app is available at http://localhost:8080.

See docs/README.md for installing, configuration, auto-tagger setup, environment variables, REST API, building from source, and other operational notes. Check the in-app help to see how to use the application (search syntax, tag input, keyboard shortcuts, ...).

---

Warning

Intended for local network use. This project is not designed for direct exposure to the public internet.

---

Acknowledgements

Thanks to @gary-host-laptop for ongoing feature requests and feedback.