ModelHub

ModelHub

Docker app from allornothing's Repository

Self-hosted, open 3D print file library manager: STL/3MF/OBJ/STEP/FBX organization, thumbnails, duplicate detection, tagging, semantic search, smart collections, filament…

Requirements

Optional: an Ollama container (install the official "ollama" template from
Community Applications first) if you want local AI instead of an API key.
Overview
Self-hosted, open 3D print file library manager: STL/3MF/OBJ/STEP/FBX organization, thumbnails, duplicate detection, tagging, semantic search, smart collections, filament inventory and a print queue. AI tagging/search can run against a local Ollama instance (nothing leaves your network) or an external OpenRouter/OpenAI-compatible API using your own key -- switch anytime from the in-app Settings tab. Point "Library Path" at the share where your STL/3MF files already live; nothing is modified on disk, files are only read and hashed. On first open you'll be asked to create an admin login (or set Admin Username/Password below to skip that screen). Also includes print time/filament weight estimates, projects that track the electronics/parts/supplies each build needs (with an exportable shopping list and a Supplies page for what you already own) and subtract the filament used when a project is marked printed, matching of your models (one by one or your whole library) to their Printables/MakerWorld listings (pictures, designer, license, tags, parts lists), a Search page across sites with a wishlist, a print log, duplicate cleanup, backup and restore, several logins, printer status and G-code upload, a page for every model and project with PDF export, a browser extension for one-click import, and optional webhook notifications (ntfy/Discord/Slack).

Model Hub

A self-hosted manager for your 3D-print file library, built for Unraid. Point it at a folder of STL, 3MF, OBJ, STEP or FBX files and it gives you thumbnails, duplicate detection, tags and a print queue.

Why use it:

  • Find things fast. Thumbnails, collections, and search that understands what a model is, not just its filename.
  • Optional AI tagging. Use a local Ollama, an OpenAI-compatible API, or turn AI off. Nothing leaves your network unless you pick an API.
  • Run your print shelf. Track filament, queue prints across printers, and keep a print log.

Image: allornothing/model-hub · Source: aon082910/model-hub

Install

Unraid: Docker tab → Add Container, then paste this into the Template field: https://raw.githubusercontent.com/aon082910/model-hub/master/unraid/model-hub.xml

Docker Compose: run docker compose up --build in the repo and open http://localhost:8420.

Setting Default What it's for
Port 8420 Web UI
/data /mnt/user/models/model-hub-library Your model files
/config /mnt/user/appdata/model-hub Database and settings
PUID / PGID 99 / 100 Owner of files it creates

First run

  1. Open the UI and create your admin account (or set AUTH_USERNAME and AUTH_PASSWORD in the template).
  2. Click Rescan Library.
  3. Optional: in Settings, pick an AI mode. For local AI, install Ollama from Community Applications and run ollama pull llava and ollama pull nomic-embed-text, then set OLLAMA_HOST to it.

Help

Questions or bugs: open an issue.

Categories

Download Statistics

5,924
Total Downloads

Related apps

Links

Details

Repository
allornothing/model-hub:latest
Last Updated2026-10-12
First Seen2026-09-03

Runtime arguments

Web UI
http://[IP]:[PORT:8420]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUI PortPorttcp

Port for the Model Hub web interface.

Target
8420
Default
8420
Value
8420
Library PathPathrw

Folder containing your STL/3MF/OBJ/STEP/FBX files. Read-only usage: files are hashed and thumbnailed, never modified.

Target
/data
Default
/mnt/user/models/model-hub-library
Value
/mnt/user/models/model-hub-library
App Config/DBPathrw

Where the SQLite database, thumbnails, and settings are stored.

Target
/config
Default
/mnt/user/appdata/model-hub
Value
/mnt/user/appdata/model-hub
PUIDVariable

Unraid's nobody user -- keeps /config editable from the host

Default
99
Value
99
PGIDVariable

Unraid's users group

Default
100
Value
100
Scan IntervalVariable

Seconds between automatic background library scans.

Target
SCAN_INTERVAL_SECONDS
Default
300
Value
300
Mesh Worker Memory (MB)Variable

Memory ceiling for the separate process that parses model files during scans. Leave blank for automatic (half of the container limit or host RAM, 1-8 GB). Files needing more are still indexed, from a preview (a .3mf's embedded thumbnail, or a streamed render of an STL) instead of a full parse. Raise it only if you have RAM to spare and want full stats on very large files.

Target
MESH_WORKER_MEMORY_MB
Ollama HostVariable

Address of your Ollama container/instance for local AI tagging. Only used when AI mode is set to 'local' in the app's Settings tab.

Target
OLLAMA_HOST
Default
http://ollama:11434
Value
http://ollama:11434
Ollama Vision ModelVariable

Vision-capable Ollama model used for auto-tagging thumbnails.

Target
OLLAMA_VISION_MODEL
Default
llava
Value
llava
Ollama Embed ModelVariable

Ollama embedding model used for semantic search.

Target
OLLAMA_EMBED_MODEL
Default
nomic-embed-text
Value
nomic-embed-text
Admin UsernameVariable

Creates the admin login automatically on first start. Leave blank to set it up from the WebUI's first-run screen instead.

Target
AUTH_USERNAME
Admin PasswordVariable

Paired with Admin Username above. Leave both blank to use the in-app setup screen instead (recommended -- avoids the password sitting in plain text in the container's env).

Target
AUTH_PASSWORD
Slicer CLI Path (advanced)Variable

Optional: absolute path *inside the container* to a headless slicer CLI binary (e.g. an extracted PrusaSlicer/OrcaSlicer AppImage) for exact print time/filament estimates instead of the built-in volumetric approximation. Bind-mount the binary in via 'Add another Path' first, then point this at it.

Target
SLICER_CLI_PATH