DataRobot CLI overview¶
The DataRobot CLI (dr) is an open source tool for working with DataRobot from your terminal. It is designed for developers and operators who want repeatable, scriptable workflows instead of doing everything from the DataRobot UI.
What the CLI is for¶
Use the CLI to:
- Authenticate against your DataRobot instance (cloud or self-managed) and locally manage credentials.
- Work with application templates. Browse, clone, and configure projects built from templates, including an interactive setup when a template defines prompts and environment variables.
- Run local development tasks. Execute the same Task-based workflows your template expects (for example,
dr run dev,dr run build,dr run test) so your machine matches how the app is meant to be built and run. - Support Agentic AI workflows. Bootstrap and run agent-oriented setups with commands such as
dr startanddr task run.
The CLI does not replace the DataRobot web application for every task; it focuses on local development, template-driven apps, and automation (including CI/CD) where a terminal interface fits best.
Common workflow¶
Most users follow a path like this:
- Install
drin your workspace (see Quick install or the full Getting started guide). - Point the CLI at your environment and sign in (see Authentication management){ target=_blank }.
- Clone or set up a template if you are building from an application template (see Working with templates).
- Run tasks defined for that project (
dr task list,dr run) as you develop.
If you are building Agentic AI workflows, the Agentic AI quickstart walks through dr start and dr task run end to end.
Where to go next¶
| If you want to… | Start here |
|---|---|
| Install and configure the CLI for the first time | Getting started |
| Look up commands without narrative | Quick reference |
Understand template layout and .env behavior |
Template system |
| Read per-command details | Command reference (below) |
Building agentic workflows?
The CLI is used to set up, run, and deploy Agentic AI workflows. See the Agentic AI quickstart to get started with dr start and dr task run.
Quick install¶
Install the latest version with a single command that auto-detects your operating system:
macOS/Linux:
¶
curl https://cli.datarobot.com/install | sh
Windows (PowerShell):
¶
irm https://cli.datarobot.com/winstall | iex
For more installation options, see Getting Started.
Documentation structure¶
User guide¶
End-user documentation for using the CLI:
- Getting started—installation and initial setup.
- Quick reference—one-page command and path reference.
- Authentication—setting up DataRobot credentials.
- Working with templates—clone and manage application templates.
- Shell completions—set up command auto-completion.
- Configuration files—understanding config file structure.
- Troubleshooting—common issues and where to find solutions.
Template system¶
Understanding the interactive template configuration:
- Template structure—how templates are organized.
- Interactive configuration—the wizard system explained.
- Environment variables—managing .env files.
Command reference¶
The command reference lists every dr command, global flags, and guidance on when to use dr start versus dr run, plus links into each topic. Common entry points:
- auth—authentication management.
- run—task execution.
- dotenv—environment variable management.
- self—CLI utility commands (version, completion).
Development guide¶
For contributors and developers:
- Building from source—compile and build the CLI.
- Development setup—local development environment.
- Project structure—codebase organization.
- Releasing—release process.
Getting help¶
If you can't find what you're looking for:
- Search existing issues.
- Open a new issue.
- Email: oss-community-management@datarobot.com.