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
Release files for horde-model-reference 8.3.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| horde_model_reference-8.3.3.tar.gz | 982.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| horde_model_reference-8.3.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / horde_model_reference-8.3.3.tar.gz
| Download URL | horde_model_reference-8.3.3.tar.gz |
|---|---|
| Size | 982.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
05573c8e965a40b4fe0df06415806878528647531ee921abf415fcd6994d3ebf
|
|
BLAKE2b-256 checksum How to use checksums |
d54c43f35301d8ebc74c3689d71b90481afc854dd318e7670d8350efaf9cc55e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / horde_model_reference-8.3.3-py3-none-any.whl
| Download URL | horde_model_reference-8.3.3-py3-none-any.whl |
|---|---|
| Size | 450.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3bbb5644494bf07e6872b1c41c85670cb9402720ac102c8ee6782b8e1c92e78
|
|
BLAKE2b-256 checksum How to use checksums |
9ce60f87245884897ae9319ff4ef9ccff9db82afae77d3702b7959ec4709e617
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log
