Horde Model Reference

The Horde Model Reference is the authoritative source for AI model metadata in the AI-Horde ecosystem. It provides validated metadata -- download URLs, checksums, baselines, NSFW flags, capabilities -- for image generation, text generation, and utility models used by workers, clients, and services.

Getting Started

I want to learn by doing.

• Getting Started -- Install, run your first query, understand the singleton pattern and prefetch strategies
• Querying Models -- Filter, sort, and aggregate models with the fluent query API
• Working with Records -- Record types, fields, type narrowing, serialization
• Configuration & Troubleshooting -- Environment variables, debugging, common issues

Concepts

I want to understand how the system works.

• Architecture Overview -- Three usage modes, backbone modules, subsystem map
• Request Lifecycle -- How the FastAPI service processes read and write requests end-to-end
• Sync System -- How PRIMARY changes propagate to legacy GitHub repositories
• Analytics Pipeline -- Statistics, audit analysis, text model grouping, and cache hydration
• Integrations -- Live Horde API data fetching, caching, and merging with model references
• Canonical Format -- API versioning (v1/v2) and canonical format configuration
• Design Decisions -- Trade-offs and known limitations explained

Reference

I need to look something up.

• Model Reference Backend -- Backend ABC, capability checks, implementation checklist
• Model Reference Records -- Record hierarchy, validation, registration pattern
• Primary Deployments -- Backend selection, Redis multi-worker setup, cache warming
• Replica Backend Base -- TTL caching and staleness tracking infrastructure
• Audit Trail -- Append-only operation logging and state replay
• Pending Queue -- Propose / approve / apply change workflow
• Legacy CSV Conversion -- Converting from legacy text generation CSV format

Code Reference

Auto-generated API documentation from source code docstrings. Browse the package reference in the Code Reference nav section, or run the FastAPI service and visit /docs for interactive Swagger UI documentation.