Principle:Guardrails ai Guardrails Hub Submission
| Knowledge Sources | |
|---|---|
| Domains | Package_Distribution, CLI |
| Last Updated | 2026-02-14 00:00 GMT |
Overview
A distribution principle for scaffolding and publishing custom validators to the Guardrails Hub for community reuse.
Description
Hub Submission is the process of packaging a custom validator for distribution through the Guardrails Hub. The guardrails create CLI command generates a configuration file that imports specified validators, instantiates a Guard with them, and produces a runnable config file. For full Hub submission, validators are packaged as independent Python modules with standard metadata and published to the Hub marketplace.
This principle supports the ecosystem growth pattern where community-created validators become discoverable and installable by other users.
Usage
Use guardrails create to scaffold a Guard configuration from Hub validators. For publishing your own validator, follow the Hub submission guidelines which involve packaging your validator module and submitting it via the Hub CLI.
Theoretical Basis
The scaffolding process:
- Select Validators: Specify Hub URIs of validators to include
- Install Dependencies: Each validator is installed via the Hub install pipeline
- Generate Config: Create a config.py with imports, Guard instantiation, and .use() calls
- Customize: Replace TODO markers with application-specific parameters