{"id":29593160,"url":"https://github.com/datarobot-oss/cli","last_synced_at":"2026-05-01T21:05:41.328Z","repository":{"id":304992061,"uuid":"972708974","full_name":"datarobot-oss/cli","owner":"datarobot-oss","description":"The DataRobot command line interface","archived":false,"fork":false,"pushed_at":"2026-04-27T17:54:41.000Z","size":322286,"stargazers_count":16,"open_issues_count":13,"forks_count":18,"subscribers_count":31,"default_branch":"main","last_synced_at":"2026-04-27T19:31:03.831Z","etag":null,"topics":["dr-engineering"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datarobot-oss.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-04-25T14:24:12.000Z","updated_at":"2026-04-27T17:54:47.000Z","dependencies_parsed_at":"2025-07-17T21:05:44.951Z","dependency_job_id":"507bb0bf-e2e5-4d9c-a44a-2132efb81391","html_url":"https://github.com/datarobot-oss/cli","commit_stats":null,"previous_names":["datarobot-oss/cli","datarobot/cli"],"tags_count":149,"template":false,"template_full_name":null,"purl":"pkg:github/datarobot-oss/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datarobot-oss%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datarobot-oss%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datarobot-oss%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datarobot-oss%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datarobot-oss","download_url":"https://codeload.github.com/datarobot-oss/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datarobot-oss%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32512708,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dr-engineering"],"created_at":"2025-07-20T06:35:36.128Z","updated_at":"2026-05-01T21:05:41.305Z","avatar_url":"https://github.com/datarobot-oss.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/datarobot-community/datarobot-agent-templates\"\u003e\n    \u003cimg src=\"./.github/datarobot_logo.avif\" width=\"600px\" alt=\"DataRobot Logo\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    \u003cspan style=\"font-size: 1.5em; font-weight: bold; display: block;\"\u003eDataRobot CLI\u003c/span\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://datarobot.com\"\u003eHomepage\u003c/a\u003e\n  ·\n  \u003ca href=\"https://docs.datarobot.com/\"\u003eDocumentation\u003c/a\u003e\n  ·\n  \u003ca href=\"https://docs.datarobot.com/en/docs/get-started/troubleshooting/general-help.html\"\u003eSupport\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/datarobot-oss/cli/tags\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/tag/datarobot-oss/cli?label=version\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"LICENSE.txt\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/datarobot-oss/cli\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# DataRobot CLI\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/datarobot/cli)](https://goreportcard.com/report/github.com/datarobot/cli)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE.txt)\n\nThe DataRobot CLI (`dr`) is a command-line interface for managing DataRobot custom applications.\nIt provides an interactive experience for cloning, configuring, and deploying DataRobot application templates with built-in authentication, environment configuration, and task execution capabilities.\n\nIf you're new to DataRobot, visit the [DataRobot documentation](https://docs.datarobot.com/) to learn more about the platform.\n\n## Features\n\n- 🔐 **Authentication management**\u0026mdash;seamless OAuth integration with DataRobot.\n- 📦 **Template management**\u0026mdash;clone and configure application templates interactively.\n- ⚙️ **Interactive configuration**\u0026mdash;smart wizard for environment setup with validation.\n- 🚀 **Task runner**\u0026mdash;execute application tasks with built-in Taskfile integration.\n- 🐚 **Shell completions**\u0026mdash;support for Bash, Zsh, Fish, and PowerShell.\n- 🔄 **Self-update capability**\u0026mdash;easily update to the latest version with a single command.\n\n## Table of contents\n\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Quick start](#quick-start)\n- [Next steps](#next-steps)\n- [Contributing](#contributing)\n- [Support](#support)\n- [Acknowledgments](#acknowledgments)\n\n## Prerequisites\n\nBefore you begin, ensure you have:\n\n- **DataRobot account**\u0026mdash;Access to a DataRobot instance (cloud or self-managed). If you don't have an account, sign up at [DataRobot](https://www.datarobot.com/) or contact your organization's DataRobot administrator.\n- **Git**\u0026mdash;For cloning templates (version 2.0+). Install Git from [git-scm.com](https://git-scm.com/downloads) if not already installed. Verify installation: `git --version`\n- **Task**\u0026mdash;For running tasks. Install Task from [taskfile.dev](https://taskfile.dev/installation/) if not already installed. Verify installation: `task --version`\n- **Terminal**\u0026mdash;Command-line interface access.\n  - **macOS/Linux:** Use Terminal, iTerm2, or your preferred terminal emulator.\n  - **Windows:** Use PowerShell, Command Prompt, or Windows Terminal.\n\n## Installation\n\nInstall the latest version with a single command:\n\n### macOS/Linux\n\n```bash\ncurl https://cli.datarobot.com/install | sh\n```\n\n### Windows (PowerShell)\n\n```powershell\nirm https://cli.datarobot.com/winstall | iex\n```\n\n\u003cdetails\u003e\u003csummary\u003e\u003cem\u003eClick here for alternative installation methods\u003c/em\u003e\u003c/summary\u003e\n\u003cbr/\u003e\nThe following are alternative installation methods for the DataRobot CLI.\nYou can choose to download a binary directly, install a specific version, or build and install from source.\n\n### Install via Homebrew / Linuxbrew (recommended)\n\n```bash\nbrew install datarobot-oss/taps/dr-cli\n```\n\n### Download binary\n\nDownload the latest release for your operating system:\n\n#### macOS\n\n```bash\n# Intel Macs\ncurl -LO https://github.com/datarobot-oss/cli/releases/latest/download/dr-darwin-amd64\nchmod +x dr-darwin-amd64\nsudo mv dr-darwin-amd64 /usr/local/bin/dr\n\n# Apple Silicon (M1/M2)\ncurl -LO https://github.com/datarobot-oss/cli/releases/latest/download/dr-darwin-arm64\nchmod +x dr-darwin-arm64\nsudo mv dr-darwin-arm64 /usr/local/bin/dr\n```\n\n#### Linux\n\n```bash\n# x86_64\ncurl -LO https://github.com/datarobot-oss/cli/releases/latest/download/dr-linux-amd64\nchmod +x dr-linux-amd64\nsudo mv dr-linux-amd64 /usr/local/bin/dr\n\n# ARM64\ncurl -LO https://github.com/datarobot-oss/cli/releases/latest/download/dr-linux-arm64\nchmod +x dr-linux-arm64\nsudo mv dr-linux-arm64 /usr/local/bin/dr\n```\n\n#### Windows\n\nDownload `dr-windows-amd64.exe` from the [releases page](https://github.com/datarobot-oss/cli/releases/latest) and add it to your PATH.\n\n### Install a specific version\n\nIf you'd like to install a specific version, you can do so by passing the version number to the installer, as shown below:\n\n#### macOS/Linux\n\n```bash\ncurl  https://cli.datarobot.com/install | sh -s -- v0.2.37\n```\n\n#### Windows (PowerShell)\n\n```powershell\n$env:VERSION = \"v0.2.37\"; irm https://cli.datarobot.com/winstall | iex\n```\n\n### Build and install from source\n\nIf you would like to build and install from source, you can do so by following the instructions below:\n\n#### Prerequisites\n\n- Go 1.25.7 or later (for building from source)\n- Git\n- [Task](https://taskfile.dev/) (for development and task running)\n\n#### Build and install from source\n\n```bash\n# Clone the repository\ngit clone https://github.com/datarobot-oss/cli.git\ncd cli\n\n# Install Task (if not already installed)\ngo install github.com/go-task/task/v3/cmd/task@latest\n\n# Build the binary\ntask build\n\n# The binary will be at ./dist/dr\n# Install it to your PATH (example for macOS/Linux)\nsudo mv ./dist/dr /usr/local/bin/dr\n```\n\n#### Windows (install a specific version)\n\n```powershell\n# Clone the repository\ngit clone https://github.com/datarobot-oss/cli.git\ncd cli\n\n# Install Task (if not already installed)\ngo install github.com/go-task/task/v3/cmd/task@latest\n\n# Build the binary\ntask build\n\n# The binary will be at .\\dist\\dr.exe\n# Add it to your PATH or move it to a directory in your PATH\n```\n\n\u003c/details\u003e\n\n### Verify installation\n\nYou can verify the installation by checking the version:\n\n```bash\ndr --version\n```\n\nYou should see output similar to:\n\n```text\nDataRobot CLI version: v0.2.37\n```\n\n### Updating the CLI\n\nTo update to the latest version of the DataRobot CLI, use the built-in update command:\n\n```bash\ndr self update\n```\n\nThis command will automatically:\n\n- Detect your installation method (Homebrew, manual installation, etc.)\n- Download the latest version\n- Install it using the appropriate method for your system\n- Preserve your existing configuration and credentials\n\nThe update process supports:\n\n- **Homebrew (macOS)**\u0026mdash;automatically upgrades via `brew upgrade --cask dr-cli`\n- **Windows**\u0026mdash;runs the latest PowerShell installation script\n- **macOS/Linux**\u0026mdash;runs the latest shell installation script\n\nAfter updating, verify the new version:\n\n```bash\ndr self version\n```\n\n## Quick start\n\nNow that you have installed the DataRobot CLI, you can start using it to manage your DataRobot applications.\nThe following sections will walk you through configuring the CLI, setting up a template, and running tasks.\n\n### Set up authentication\n\nFirst, configure your DataRobot credentials by setting your DataRobot URL.\nRefer to [DataRobot's API keys and tools page](https://docs.datarobot.com/en/docs/platform/acct-settings/api-key-mgmt.html) for steps to locate your DataRobot URL, also known as your DataRobot API endpoint.\n\n```bash\n# Set your DataRobot URL (interactive)\ndr auth set-url\n```\n\n\u003cdetails\u003e\u003csummary\u003e\u003cem\u003eClick here for more information about configuration files\u003c/em\u003e\u003c/summary\u003e\n\u003cbr/\u003e\nConfiguration files are stored in:\n\n- **Linux/macOS:** `~/.config/datarobot/drconfig.yaml`\n- **Windows:** `%USERPROFILE%\\.config\\datarobot\\drconfig.yaml`\n\nSee [Configuration files](docs/user-guide/configuration.md) for more details.\n\u003c/details\u003e\n\nYou'll be prompted to enter your DataRobot URL. You can use shortcuts for cloud instances:\n\n- Enter `1` for `https://app.datarobot.com`\n- Enter `2` for `https://app.eu.datarobot.com`\n- Enter `3` for `https://app.jp.datarobot.com`\n- Enter a valid URL if you have a custom/self-managed instance\n\nAlternatively, set the URL directly:\n\n```bash\ndr auth set-url https://app.datarobot.com\n```\n\nOnce you have configured the URL, log in to DataRobot using OAuth:\n\n```bash\ndr auth login\n```\n\nThis will:\n\n1. Open your default web browser\n2. Redirect you to the DataRobot login page\n3. Request authorization\n4. Automatically save your credentials\n\nYour API key will be securely stored in `~/.config/datarobot/drconfig.yaml`.\n\n### Verify authentication\n\nCheck that you're logged in:\n\n```bash\ndr templates list\n```\n\nThis command displays a list of available templates from your DataRobot instance.\n\n\u003e [!TIP]\n\u003e **What's next?** Now that you're authenticated, you can:\n\u003e\n\u003e - Browse available templates: `dr templates list`\n\u003e - Start the setup wizard: `dr templates setup`\n\u003e - See the [Command reference](docs/commands/) for all available commands\n\n### Set up a template\n\nNext, load the interactive setup wizard to clone and configure a template.\nA **template** is a pre-configured application scaffold that you can customize.\nWhen you clone and configure a template, it becomes your **application**\u0026mdash;a customized instance ready to run and deploy.\n\n```bash\ndr templates setup\n```\n\nAfter a few moments, the setup wizard displays the application templates available:\n\n\u003cimg src=\"./images/templates-list.png\" alt=\"Templates list\" width=\"500px\"/\u003e\n\n\u003e [!NOTE]\n\u003e You can navigate through the list of templates using the arrow keys, or filter by pressing the `/` key and entering a search term. The setup wizard will only display templates that are available to you.\n\nSelect a template by pressing the `Enter` key.\nAt the subsequent prompt, specify the desired directory name for the template and press `Enter` to have the setup wizard clone the template repository to your local machine.\n\n\u003cdetails\u003e\u003csummary\u003e\u003cem\u003eClick here for manual setup instructions\u003c/em\u003e\u003c/summary\u003e\n\u003cbr/\u003e\n\n**Manual setup:** If you prefer manual control:\n\n```bash\n# 1. List available templates.\ndr templates list\n\n# 2. Set up a template (this clones and configures it).\ndr templates setup\n\n# 3. Navigate to the template directory.\ncd TEMPLATE_NAME\n\n# 4. Configure environment variables (if not done during setup).\ndr dotenv setup\n```\n\n\u003e [!TIP]\n\u003e **What's next?** After configuring your template:\n\u003e\n\u003e - Start your application: `dr start` or `dr run dev`\n\u003e - Explore available tasks: `dr task list`\n\u003e - See [Run tasks](#run-tasks) below\n\u003e\n\u003c/details\u003e\n\nFollow the instructions when prompted to continue configuring the template.\nThe prompts vary depending on which template you selected.\nWhen all steps are finished, press `Enter` to exit the wizard and proceed to the next section.\n\n\u003e [!NOTE]\n\u003e The CLI automatically tracks setup completion in a state file located at `.datarobot/cli/state.yaml` within your template directory. This allows the CLI to skip redundant setup steps on subsequent runs. For more details, see [State tracking](docs/user-guide/configuration.md#state-tracking).\n\n\u003e [!TIP]\n\u003e **What's next?** After the setup wizard completes, navigate to your new application directory with `cd [template-name]` and start your application with `dr start` or `dr run dev`.\n\n### Run tasks\n\nNow that you've cloned and configured a template, you can start running tasks defined in the template Taskfile.\n\n**Quick start (recommended):**\n\nUse the `start` command for automated initialization:\n\n```bash\ndr start\n```\n\nThis command will:\n\n- Check prerequisites and validate your environment.\n- Verify your CLI version meets the template's minimum requirements.\n- Check if you're in a DataRobot repository (if not, launches template setup).\n- Execute a start command in this order:\n  1. `task start` from the Taskfile (if available)\n  2. A quickstart script from `.datarobot/cli/bin/` (if available)\n  3. Fall back to the setup wizard if neither exists.\n\n\u003e [!TIP]\n\u003e You can use the `--yes` flag to skip all prompts and execute immediately. This is useful in scripts or CI/CD pipelines.\n\n**Running specific tasks:**\n\nFor more control, execute individual tasks with the `run` command:\n\n```bash\n# List available tasks\ndr task list\n\n# Run the development server\ndr run dev\n\n# Or execute specific tasks\ndr run build\ndr run test\n```\n\n\u003e [!TIP]\n\u003e **What's next?** Your application is now running! Explore the [Template system](docs/template-system/) documentation, set up [shell completions](docs/user-guide/shell-completions.md), or review the [Command reference](docs/commands/) for detailed command documentation.\n\n## Next steps\n\nFrom here, refer to the repository of the template you selected to start customizing it.\nRefer to the [Docs](/docs/) section of this repository for more details on using the DataRobot CLI.\nSee the links below for specific details:\n\n- **[User guide](docs/user-guide/README.md)**\u0026mdash;complete usage guide covering installation, authentication, working with templates, configuration management, and shell completions.\n- **[Quick reference](docs/user-guide/quick-reference.md)**\u0026mdash;one-page command reference for the most common commands.\n- **[Template system](docs/template-system/)**\u0026mdash;deep dive into how templates work, the interactive configuration wizard, and environment variable management.\n- **[Command reference](docs/commands/)**\u0026mdash;detailed documentation for all CLI commands and subcommands, including flags, options, and usage examples.\n- **[Auth command](docs/commands/auth.md)**\u0026mdash;detailed authentication management guide.\n- **[Development guide](docs/development/)**\u0026mdash;for contributors: building from source, development setup, project structure, and release process.\n\n## Common issues\n\n### \"dr: command not found\"\n\n**Why it happens:** The CLI binary isn't in your system's PATH, so your shell can't find it.\n\n**How to fix:**\n\n```bash\n# Check if dr is in PATH\nwhich dr\n\n# If not found, verify the binary location\nls -l /usr/local/bin/dr\n\n# Add it to your PATH (for current session)\nexport PATH=\"/usr/local/bin:$PATH\"\n\n# For permanent fix, add to your shell config file:\n# Bash: echo 'export PATH=\"/usr/local/bin:$PATH\"' \u003e\u003e ~/.bashrc\n# Zsh:  echo 'export PATH=\"/usr/local/bin:$PATH\"' \u003e\u003e ~/.zshrc\n```\n\n**How to prevent:** Re-run the installation script or ensure the binary is installed to a directory in your PATH.\n\n### \"Failed to read config file\"\n\n**Why it happens:** The configuration file doesn't exist yet or is in an unexpected location. This typically occurs on first use before authentication.\n\n**How to fix:**\n\n```bash\n# Set your DataRobot URL (creates config file if missing)\ndr auth set-url https://app.datarobot.com\n\n# Authenticate (saves credentials to config file)\ndr auth login\n```\n\n**How to prevent:** Run `dr auth set-url` and `dr auth login` as part of your initial setup. The config file is automatically created at `~/.config/datarobot/drconfig.yaml`.\n\n### \"Authentication failed\"\n\n**Why it happens:** Your API token may have expired, been revoked, or the DataRobot URL may have changed. This can also occur if the config file is corrupted.\n\n**How to fix:**\n\n```bash\n# Clear existing credentials\ndr auth logout\n\n# Re-authenticate\ndr auth login\n\n# If issues persist, verify your DataRobot URL\ndr auth set-url https://app.datarobot.com  # or your instance URL\ndr auth login\n```\n\n**How to prevent:** Regularly update the CLI (`dr self update`) and re-authenticate if you change DataRobot instances or if your organization rotates API keys.\n\n## Getting help\n\nFor additional help:\n\n```bash\n# General help\ndr --help\n\n# Command-specific help\ndr auth --help\ndr templates --help\ndr run --help\n\n# Enable verbose output for debugging\ndr --verbose templates list\n\n# Enable debug output for detailed information\ndr --debug templates list\n\nWhen you enable debug mode, the CLI creates a `.dr-tui-debug.log` file in the home directory for terminal UI debug information.\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on:\n\n- Code of conduct.\n- Development workflow.\n- Submitting pull requests.\n- Coding standards.\n- Testing requirements.\n\n## Support\n\n- 📖 [Documentation](docs/)\n- 🐛 [Issue Tracker](https://github.com/datarobot/cli/issues)\n- 💬 [Discussions](https://github.com/datarobot/cli/discussions)\n- 📧 Email: \u003coss-community-management@datarobot.com\u003e\n\n## Acknowledgments\n\nBuilt with:\n\n- [Cobra](https://github.com/spf13/cobra)\u0026mdash;CLI framework.\n- [Bubble Tea](https://github.com/charmbracelet/bubbletea)\u0026mdash;terminal UI framework.\n- [Viper](https://github.com/spf13/viper)\u0026mdash;configuration management.\n- [Task](https://taskfile.dev/)\u0026mdash;task runner.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatarobot-oss%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatarobot-oss%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatarobot-oss%2Fcli/lists"}