> This page is for version 0.8.
> For other versions, use one of these documentation indexes:
> - Latest (default): https://docs.nvidia.com/nemo-helix/latest/llms.txt
> - 0.9: https://docs.nvidia.com/nemo-helix/v0.9/llms.txt
> - 0.8: https://docs.nvidia.com/nemo-helix/v0.8/llms.txt
> - 0.7: https://docs.nvidia.com/nemo-helix/v0.7/llms.txt
> - 0.6: https://docs.nvidia.com/nemo-helix/v0.6/llms.txt
> - 0.5: https://docs.nvidia.com/nemo-helix/v0.5/llms.txt

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

# NeMo Studio Virtual Models

> Inspect inference routes in Studio when the Guardrails preview feature is enabled.

> **Warning**
>
> The Virtual Models Studio UI is a preview feature and is disabled by default. An administrator must set `studio.feature_flags.guardrails_enabled: true` in the platform configuration and restart Studio before **Models > Virtual Models** appears. This flag also enables **Governance > Guardrails**.

Use **Models > Virtual Models** in the NeMo Studio workspace sidebar to inspect inference routes and their middleware pipelines for the selected workspace.

## Virtual Model List

The Virtual Models table shows all user-created virtual models in the current workspace. Controller-managed passthrough routes are hidden. Select a row or choose **View** from the row actions menu to open the virtual model detail page.

| Action                 | Where                                  | Result                                                                    |
| ---------------------- | -------------------------------------- | ------------------------------------------------------------------------- |
| View details           | Select a row or row actions > **View** | Opens the virtual model detail page on the **Details** tab.               |
| Chat                   | Row actions > **Chat**                 | Opens the virtual model detail page on the **Chat** tab.                  |
| Search                 | **Search by name...** search bar       | Filters the list to virtual models whose names match the query.           |
| Filter by base model   | **Default Model** filter               | Shows only virtual models backed by the selected base model.              |
| Filter by date         | **Created At** filter                  | Narrows results to a specific creation date range.                        |
| Delete a virtual model | Row actions > **Delete**               | Removes the virtual model and its middleware pipelines after you confirm. |

The table shows each virtual model's name, default model, middleware call count (or **None**), and creation time.

Virtual models are created and updated through the `nemo inference virtual-models` CLI or the Inference Gateway API; see [Virtual Models](/nemo-helix/v0.8/documentation/models-and-inference/virtual-models). NeMo Studio reflects the current workspace state.

## Virtual Model Details

Selecting a row opens the detail page for a single virtual model. The page has two tabs: **Details** shows the virtual model's full configuration, and **Chat** lets you send messages through the virtual model.

### Summary

The **Details** tab lists the following fields.

| Field           | Description                                                                                                                                                                                                                                                                                   |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Created         | When the virtual model was first created.                                                                                                                                                                                                                                                     |
| Default model   | The backend model entity IGW routes requests to, if configured. When omitted, a request middleware plugin handles backend routing.                                                                                                                                                            |
| Autoprovisioned | Whether the route is controller-managed. The Models controller deletes controller-managed virtual models once no ModelProvider serves the matching entity; setting this field manually opts the virtual model into that cleanup behavior. Controller-managed models are hidden from the list. |
| Override proxy  | An optional plugin-provided proxy identifier (format: `plugin-name.proxy-name`) that overrides the default IGW proxy, if set.                                                                                                                                                                 |
| Models          | Backend model entries associated with this virtual model, displayed as `model (backend_format)`.                                                                                                                                                                                              |

### Middleware

The **Details** tab shows three ordered middleware pipelines applied to every request through this virtual model.

| Pipeline                 | When it runs                                                             |
| ------------------------ | ------------------------------------------------------------------------ |
| Request middleware       | Before the request reaches the backend model.                            |
| Response middleware      | After the model responds, before the response is returned to the caller. |
| Post-response middleware | After the response is returned to the caller.                            |

Each middleware entry shows its plugin name, config type, config reference, and inline config payload if one is set. A guardrails middleware entry, for example, shows the plugin `nemo-guardrails`, the config type `guardrail_config`, and a config ID pointing to a workspace guardrail configuration.

### Chat

The **Chat** tab opens a chat session that sends requests through the virtual model, so its middleware pipelines (for example, guardrails) apply to every message. Use the **Inference parameters** control above the chat to adjust settings such as temperature and max tokens.