Skip to main content

Horde Model Reference

Haidra Logo

Build Status PyPI Version Supported Python versions License: AGPL v3

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.

Runnable examples live in the examples/ directory.

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup and guidelines, and see the open issues.

Community

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.

Metadata

Release files for horde-model-reference 8.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for horde-model-reference 8.7.1
File Size Uploaded Provenance Actions
horde_model_reference-8.7.1.tar.gz 1.1 MB With provenance Details for horde_model_reference-8.7.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for horde-model-reference 8.7.1
File Interpreter ABI Platform Actions
horde_model_reference-8.7.1-py3-none-any.whl Python 3 none any Details for horde_model_reference-8.7.1-py3-none-any.whl

Total release size: 1.5 MB

Release files / horde_model_reference-8.7.1.tar.gz

Download URL horde_model_reference-8.7.1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
b30f6226a5aba07d24ddf6646cfc98eba5366c069cc7782a887e7d3daafb7e2a
BLAKE2b-256 checksum
How to use checksums
53de3c14b4a1764409ad7e4a575956499299c9568cf13a983df9f82f060d7285
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 5, 2026.

Transparency log

Release files / horde_model_reference-8.7.1-py3-none-any.whl

Download URL horde_model_reference-8.7.1-py3-none-any.whl
Size 465.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cfb63350f3f34288c0962ab31da32099eecaa07e1cd117c94243c7b0159f531c
BLAKE2b-256 checksum
How to use checksums
1ad850570cb5881ac03060b4446e5349b2707913de2bb21b94b653aa9fdde87d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 5, 2026.

Transparency log

Security for horde-model-reference 8.7.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for horde_model_reference-8.7.1.tar.gz

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 Nov 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

8.7.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page