Template management

開発者向けドキュメント > DataRobot CLI > Template management

Template management¶

Manage DataRobot application templates: list available templates, clone repositories, run the interactive setup wizard, and check template status.

Synopsis¶

dr templates <command> [arguments] [flags]

説明¶

The templates command provides subcommands for discovering, cloning, and configuring application templates from your DataRobot instance. Templates are pre-configured application scaffolds that you customize into your own application.

Subcommands¶

`list`¶

List available templates from your DataRobot instance.

dr templates list

Behavior:

Requires authentication. Run dr auth login if not already authenticated.
Fetches templates from the DataRobot API that are available to your user and organization.
Displays template names and descriptions.

例：

$ dr templates list
Available templates:
* python-streamlit     - Streamlit application template
* react-frontend       - React frontend template
* fastapi-backend      - FastAPI backend template

Flags: All global flags apply (e.g., --verbose, --debug, --skip-auth).

`setup`¶

Run the interactive setup wizard to select, clone, and configure a template.

dr templates setup

Behavior:

Displays a list of templates available to you.
You select a template and specify a directory name; the wizard clones the template there.
Guides you through environment configuration (or skips it if already completed; see State tracking).
Optionally runs dr dotenv setup if the template has environment prompts.

For details on the template system and configuration wizard, see Template system and Interactive configuration.

Template selection screen¶

When the setup wizard runs, you see a template list screen:

Navigate the list with the arrow keys (↑/↓).
Filter templates by pressing / and typing a search term.
Select a template by pressing Enter.
At the next prompt, enter the desired directory name for the cloned template and press Enter to clone.

Only templates that are available to your user account are shown. After cloning, the wizard continues with configuration steps as needed.

Flags: All global flags apply. Use --force-interactive to run the wizard even if setup was previously completed.

`clone`¶

Clone a template repository by name (and optional target directory).

dr templates clone <template-name> [directory]

Arguments:

template-name — Name or identifier of the template (as shown by dr templates list).
directory (optional) — Local directory name or path for the clone. If omitted, the template name is used.

例：

# Clone into a directory named after the template
dr templates clone python-streamlit

# Clone into a custom directory
dr templates clone python-streamlit my-app

Behavior:

Requires authentication.
Clones the template's Git repository to the current working directory.
After cloning, run dr dotenv setup to configure environment variables, or use dr templates setup to run the full wizard (which includes clone + configuration).

`status`¶

Show the current template's status (version, modifications, updates).

dr templates status

Behavior:

Must be run from within a cloned template directory.
Shows current version, latest available version (if applicable), modified files, and whether updates are available.

例：

$ dr templates status
Template: python-streamlit
Current version: 1.0.0
Modified files: .env (local only)

Global flags¶

All dr global flags apply to dr templates subcommands:

-v, --verbose — Verbose output
--debug — Debug output (creates dr-tui-debug.log in current directory for TUI debugging)
--skip-auth — Skip authentication checks (advanced; API calls may fail)
--force-interactive — Force setup wizard to run even if already completed
-h, --help — Help

Choosing templates vs. setup¶

Use dr templates setup when you want a guided, all-in-one flow: select template, clone, and configure in one session. Recommended for most users.
Use dr templates list and dr templates clone when you prefer to clone first and configure manually (e.g., dr dotenv setup afterward).

Template management