> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/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)**

## 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'
```