NeMo Guardrails Library CLI Reference
NeMo Guardrails Library CLI Reference
You should now be able to invoke the nemoguardrails CLI.
You can also use the --help flag to learn more about each of the nemoguardrails commands.
chat
Chat with a Colang 2.x configuration, including its debugger commands, is deprecated in 0.25.0; removal is planned no earlier than 0.27.0.
nemoguardrails chat prints this notice to standard error when it loads a Colang 2.x configuration.
For the steps, refer to Migrating to 0.25.
Options
actions-server
Start a separate server process for running custom actions. Process separation does not sandbox action code or restrict its filesystem and network access.
Options
server
Start the FastAPI server for serving guardrails configurations over HTTP.
Options
hooks-server
Start the Guardrails hooks server, which checks coding agents’ tool calls from their pre-tool hooks.
It is a separate server from server, with its own endpoints and defaults.
For details, refer to Run the Hooks Server.
Options
eval
Evaluate guardrail configurations with various testing and compliance workflows.
The following example runs the interactions in the sample ABC evaluation configuration (-e) through the ABC bot guardrails configuration (-g):
Subcommands
Use nemoguardrails eval <subcommand> --help for details on each subcommand.
convert
Convert Colang files and configurations from older versions to the latest format.
Arguments
Options
find-providers
List and select LLM providers interactively. This command helps you discover available providers for text completion and chat completion models.
Options
List Mode
Run the following command to list all available providers:
Interactive Mode
Run the command without options to start an interactive provider selection:
-
Select a provider type:
- Type to filter between “text completion” and “chat completion”.
- Use arrow keys to navigate through matches.
- Press Tab to autocomplete.
- Press Enter to select.
-
Select a specific provider:
- Type to filter through available providers.
- Use arrow keys to navigate through matches.
- Press Tab to autocomplete.
- Press Enter to select.