horde-model-reference 4.0.0

A helper library providing a way to work with the lists of generation models, utility models, and any other related files required for the AI-Horde ecosystem.

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-reference channel
• 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