Horde Model Reference
Horde Model Reference is the authoritative source for AI model metadata in the AI-Horde ecosystem: download URLs, SHA-256 checksums, baselines, NSFW flags, and capabilities for image generation, text generation, and utility models used by workers, clients, and services.
It is three things in one package: a set of JSON reference files, a Python library, and a FastAPI service.
Install
pip install horde-model-reference
Quick try
from horde_model_reference import ModelReferenceManager, MODEL_REFERENCE_CATEGORY
manager = ModelReferenceManager() # auto-fetches from the PRIMARY server, caches in memory
models = manager.get_model_reference(MODEL_REFERENCE_CATEGORY.image_generation)
for name, model in models.items():
print(f"{name}: {model.baseline}, NSFW={model.nsfw}")
No configuration needed -- the defaults work out of the box. The library runs in read-only REPLICA mode, fetching from models.aihorde.net with automatic fallback to the original GitHub repositories if the PRIMARY server is unreachable.
For the fluent query API (filter, sort, aggregate, merge sources), HTTP API access, deploying your own server, or contributing model data, see the full documentation.
Documentation
Full docs at horde-model-reference.readthedocs.io/en/latest/. Build locally with mkdocs serve.
- Getting Started -- first query, singleton pattern, prefetch strategies
- Querying Models -- filter, sort, aggregate with the fluent API
- Using the HTTP API -- call the live service over HTTP
- Filter Models for a Worker -- narrow the reference to what your node should serve
- Configuration & Troubleshooting -- env vars, debugging, common issues
- Deployment Guide -- run your own PRIMARY server
Runnable examples live in the examples/ directory.
Contributing
Contributions are welcome. Read CONTRIBUTING.md for setup and guidelines, and see the open issues.
Community
- Discord: AI Horde Discord --
#horde-model-referencechannel - Bug reports: GitHub Issues
- Feature requests: GitHub Discussions
License
Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE for the full text. If you run a modified version as a network service, you must make your source code available to users. See the GNU AGPL FAQ for details.
Related Projects
- AI-Horde -- main AI-Horde API server
- horde-worker-reGen -- official image generation worker
- horde-sdk -- Python SDK for the AI-Horde API
- hordelib -- library wrapper around ComfyUI
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file horde_model_reference-8.0.0.tar.gz.
File metadata
- Download URL: horde_model_reference-8.0.0.tar.gz
- Upload date:
- Size: 973.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5a847bfa00b336b9d2a991dc6459f89871de20d0d2932d4fa67fa5be20f309ec
|
|
| MD5 |
ed0e28f3ccee6c5705bcb7f9a475f524
|
|
| BLAKE2b-256 |
93bd89c2d90bc3c8dd3a0c651bbbed3135a641b9bcb78784dfde525d0f7f1624
|
Provenance
The following attestation bundles were made for horde_model_reference-8.0.0.tar.gz:
Publisher:
release.yml on Haidra-Org/horde-model-reference
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
horde_model_reference-8.0.0.tar.gz -
Subject digest:
5a847bfa00b336b9d2a991dc6459f89871de20d0d2932d4fa67fa5be20f309ec - Sigstore transparency entry: 2578878080
- Sigstore integration time:
-
Permalink:
Haidra-Org/horde-model-reference@d2bb18f79f49e0ce5d2a32c5c68ce39618e7ec67 -
Branch / Tag:
refs/tags/v8.0.0 - Owner: https://github.com/Haidra-Org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d2bb18f79f49e0ce5d2a32c5c68ce39618e7ec67 -
Trigger Event:
push
-
Statement type:
File details
Details for the file horde_model_reference-8.0.0-py3-none-any.whl.
File metadata
- Download URL: horde_model_reference-8.0.0-py3-none-any.whl
- Upload date:
- Size: 446.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
acaa1cf1f1bc3844d0f13f32982474b28ef5aef52435cd6c63dd164d10ffd20b
|
|
| MD5 |
111dbd93d642f04c6cb7016452d7415d
|
|
| BLAKE2b-256 |
7a77857661eba2a06ee8787e4928dfc416060859c7b5b5df5f301df3f6bb4ecc
|
Provenance
The following attestation bundles were made for horde_model_reference-8.0.0-py3-none-any.whl:
Publisher:
release.yml on Haidra-Org/horde-model-reference
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
horde_model_reference-8.0.0-py3-none-any.whl -
Subject digest:
acaa1cf1f1bc3844d0f13f32982474b28ef5aef52435cd6c63dd164d10ffd20b - Sigstore transparency entry: 2578878164
- Sigstore integration time:
-
Permalink:
Haidra-Org/horde-model-reference@d2bb18f79f49e0ce5d2a32c5c68ce39618e7ec67 -
Branch / Tag:
refs/tags/v8.0.0 - Owner: https://github.com/Haidra-Org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@d2bb18f79f49e0ce5d2a32c5c68ce39618e7ec67 -
Trigger Event:
push
-
Statement type:
