> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/guardrails/_mcp/server.

# nemoguardrails.guardrails

## Submodules

* **[`nemoguardrails.guardrails._http`](/guardrails-python-sdk/nemoguardrails/guardrails/_http)**
* **[`nemoguardrails.guardrails.api_engine`](/guardrails-python-sdk/nemoguardrails/guardrails/api_engine)**
* **[`nemoguardrails.guardrails.async_work_queue`](/guardrails-python-sdk/nemoguardrails/guardrails/async_work_queue)**
* **[`nemoguardrails.guardrails.base_engine`](/guardrails-python-sdk/nemoguardrails/guardrails/base_engine)**
* **[`nemoguardrails.guardrails.engine_registry`](/guardrails-python-sdk/nemoguardrails/guardrails/engine_registry)**
* **[`nemoguardrails.guardrails.guardrails`](/guardrails-python-sdk/nemoguardrails/guardrails/guardrails)**
* **[`nemoguardrails.guardrails.guardrails_types`](/guardrails-python-sdk/nemoguardrails/guardrails/guardrails_types)**
* **[`nemoguardrails.guardrails.iorails`](/guardrails-python-sdk/nemoguardrails/guardrails/iorails)**
* **[`nemoguardrails.guardrails.model_engine`](/guardrails-python-sdk/nemoguardrails/guardrails/model_engine)**
* **[`nemoguardrails.guardrails.rail_action`](/guardrails-python-sdk/nemoguardrails/guardrails/rail_action)**
* **[`nemoguardrails.guardrails.rails_manager`](/guardrails-python-sdk/nemoguardrails/guardrails/rails_manager)**
* **[`nemoguardrails.guardrails.telemetry`](/guardrails-python-sdk/nemoguardrails/guardrails/telemetry)**
* **[`nemoguardrails.guardrails.tool_rail_action`](/guardrails-python-sdk/nemoguardrails/guardrails/tool_rail_action)**
* **[`nemoguardrails.guardrails.tool_schema`](/guardrails-python-sdk/nemoguardrails/guardrails/tool_schema)**

## Package Contents

### Functions

| Name                                                                | Description                                                    |
| ------------------------------------------------------------------- | -------------------------------------------------------------- |
| [`configure_logging`](#nemoguardrails-guardrails-configure_logging) | Configure logging for the `nemoguardrails.guardrails` package. |

### Data

[`DEFAULT_DATEFMT`](#nemoguardrails-guardrails-DEFAULT_DATEFMT)

[`DEFAULT_FORMAT`](#nemoguardrails-guardrails-DEFAULT_FORMAT)

### API

```python
nemoguardrails.guardrails.configure_logging(
    level: int = logging.INFO,
    formatter: logging.Formatter | None = None,
    handler: logging.Handler | None = None
) -> logging.Logger
```

Configure logging for the `nemoguardrails.guardrails` package.

Attaches a handler if none exist, or updates existing handlers if they do.
**If a handler is provided on repeat calls, it is ignored to avoid accumulating handlers.**
Sets level and formatter of all handlers so that all modules under this package
(model_engine, api_engine, rails_manager, etc.) inherit the same settings.

```python
nemoguardrails.guardrails.DEFAULT_DATEFMT = '%Y-%m-%d %H:%M:%S'
```

```python
nemoguardrails.guardrails.DEFAULT_FORMAT = '%(asctime)s %(levelname)s: %(message)s'
```

## Docs

- [nemoguardrails.guardrails._http](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/_http.md)
- [nemoguardrails.guardrails.api_engine](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/api_engine.md)
- [nemoguardrails.guardrails.async_work_queue](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/async_work_queue.md)
- [nemoguardrails.guardrails.base_engine](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/base_engine.md)
- [nemoguardrails.guardrails.engine_registry](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/engine_registry.md)
- [nemoguardrails.guardrails.guardrails](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/guardrails.md)
- [nemoguardrails.guardrails.guardrails_types](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/guardrails_types.md)
- [nemoguardrails.guardrails.iorails](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/iorails.md)
- [nemoguardrails.guardrails.model_engine](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/model_engine.md)
- [nemoguardrails.guardrails.rail_action](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/rail_action.md)
- [nemoguardrails.guardrails.rails_manager](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/rails_manager.md)
- [nemoguardrails.guardrails.telemetry](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/telemetry.md)
- [nemoguardrails.guardrails.tool_rail_action](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/tool_rail_action.md)
- [nemoguardrails.guardrails.tool_schema](https://docs.nvidia.com/nemo/guardrails/v0.23.0/guardrails-python-sdk/nemoguardrails/guardrails/tool_schema.md)