For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Welcome
    • Contributing
  • Concepts
    • Columns
    • Seed Datasets
    • Agent Rollout Ingestion
      • Default Model Settings
      • Configure with the CLI
      • Custom Model Settings
      • Model Providers
      • Model Configs
      • Inference Parameters
    • Custom Columns
    • Validators
    • Processors
    • Person Sampling
    • Traces
    • Architecture & Performance
    • Deployment Options
    • Security
  • Tutorials
    • Overview
    • The Basics
    • Structured Outputs, Jinja Expressions, and Conditional Generation
    • Seeding with an External Dataset
    • Providing Images as Context
    • Generating Images
    • Image-to-Image Editing
  • Recipes
    • Recipe Cards
  • Plugins
    • Overview
    • Example Plugin
    • FileSystemSeedReader Plugins
    • Discover
  • Code Reference
    • Overview
  • Dev Notes
    • Overview
    • Prompt Sensitivity
    • Retriever SDG Toolkit
    • Have It Your Way
    • VLM Long Document Understanding
    • Push Datasets to Hugging Face Hub
    • Text-to-SQL for Nemotron Super
    • Async All the Way Down
    • Owning the Model Stack
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Manage My Privacy | Do Not Sell or Share My Data | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogoNeMo Data Designer
On this page
  • Configuration Files
  • CLI Commands
  • Managing Model Providers
  • Available Operations
  • Managing Model Configurations
  • Available Operations
  • Listing Configurations
  • Resetting Configurations
  • See Also
ConceptsModels

Configuring Model Settings Using The CLI

||View as Markdown|
Previous

Default Model Settings

Next

Custom Model Settings

The Data Designer CLI provides an interactive interface for creating and managing default model providers and model configurations stored in your Data Designer home directory (default: ~/.data-designer/).

Configuration Files

The CLI manages two YAML configuration files:

  • model_providers.yaml: Model provider configurations
  • model_configs.yaml: Model configurations

Automatic Configuration If these configuration files don’t already exist, the Data Designer library automatically creates them with default settings at runtime when first initialized.

Custom Directory You can customize the configuration directory location with the DATA_DESIGNER_HOME environment variable:

$export DATA_DESIGNER_HOME="/path/to/your/custom/directory"

CLI Commands

The Data Designer CLI provides four main configuration commands:

$# Configure model providers
$data-designer config providers
$
$# Configure models
$data-designer config models
$
$# List current configurations
$data-designer config list
$
$# Reset all configurations
$data-designer config reset

Getting help See available commands

$data-designer --help

See available sub-commands

$data-designer config --help

Managing Model Providers

Run the interactive provider configuration command:

$data-designer config providers

Available Operations

Add a new provider: Define a new provider by entering its name, endpoint URL, provider type, and optionally an API key (as plain text or as an environment variable name).

Update an existing provider: Modify an existing provider’s settings. All fields are pre-filled with current values.

Delete a provider: Remove a provider and its associated models.

Delete all providers: Remove all providers and their associated models.

Change default provider: Set which provider is used by default. This option is only available when multiple providers are configured.

Deprecated: 'Change default provider' workflow

The “Change default provider” workflow is deprecated and will be removed in a future release alongside the registry-level default. Specify provider= explicitly on each ModelConfig instead — the workflow now emits a DeprecationWarning when entered. See issue #589.

Managing Model Configurations

Run the interactive model configuration command:

$data-designer config models

Provider Required You need at least one provider configured before adding models. Run data-designer config providers first if none exist.

Available Operations

Add a new model configuration

Create a new model configuration with the following fields:

  • Alias: A unique name for referencing this model in a column configuration.
  • Model ID: The model identifier (e.g., nvidia/nemotron-3-nano-30b-a3b)
  • Provider: Select from available providers (if multiple exist)
  • Temperature: Sampling temperature (0.0 to 2.0)
  • Top P: Nucleus sampling parameter (0.0 to 1.0)
  • Max Tokens: Maximum output length (1 to 100000)

Additional Settings To configure additional inference parameter settings or use distribution-based inference parameters, edit the model_configs.yaml file directly.

Update an existing model configuration: Modify an existing model’s configuration. All fields are pre-filled with current values.

Delete a model configuration: Remove a single model configuration.

Delete all model configurations: Remove all model configurations. The CLI will ask for confirmation before proceeding.

Listing Configurations

View all current configurations:

$data-designer config list

This command displays:

  • Model Providers: All configured providers with their endpoints (API keys are masked)
  • Default Provider: The currently selected default provider (deprecated; see issue #589)
  • Model Configurations: All configured models with their settings

Resetting Configurations

Delete all configuration files:

$data-designer config reset

The CLI will show which configuration files exist and ask for confirmation before deleting them.

Destructive Operation This command permanently deletes all configuration files and resets to the default model providers and configurations. You’ll need to reconfigure your custom configurations from scratch.

See Also

  • Default Model Settings: Pre-configured providers and model settings included with Data Designer
  • Custom Model Settings: Learn how to create custom providers and model configurations
  • Model Providers: Learn about the ModelProvider class and provider configuration
  • Model Configurations: Learn about ModelConfig
  • Getting Started: Installation and basic usage example