toks-love/modelharbor

Source: https://github.com/toks-love/modelharbor

ModelHarbor

A model library on your own storage.
Find models on the Hugging Face Hub, keep exactly the files you want, and read them from a plain folder.

ModelHarbor is self-hosted software for local model weights. It is not affiliated with or endorsed by Hugging Face.

Run it

ModelHarbor ships as a container. Running it needs Docker and two host directories: one for model files, one for application state.

mkdir modelharbor && cd modelharbor
curl -O https://raw.githubusercontent.com/toks-love/modelharbor/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/toks-love/modelharbor/main/.env.example

Edit .env — MODEL_STORAGE_PATH is the host directory that holds models — then:

docker compose up -d

Open port 7860. The first visit creates the owner account, which adds member accounts from Settings. docker compose down stops the service; model files and the database are preserved.

Session cookies are marked Secure by default, so sign-ins persist once HTTPS terminates in front of the app. On a plain-HTTP LAN, the template documents the escape hatch.

Windows users can run it with Docker Desktop through the helpers in deploy/desktop; the same document covers the compose route and a source checkout in full.

Documentation

License

ModelHarbor is released under the MIT License (see LICENSE). It is based on the open-source HuggingHack project; attribution is preserved there and in THIRD-PARTY.md.

AI assistance

toks.love developed ModelHarbor with AI assistance: an agent wrote most of the code under the careful direction and review of toks.love. toks.love owns the code, as well as any mistakes or omissions; the MIT License above applies in full.