---
title: Install the Datadog Agent Integration Developer Tool
description: Install the Datadog Agent Integration Developer Tool.
breadcrumbs: >-
  Docs > Extend Datadog > Datadog Integrations > Install the Datadog Agent
  Integration Developer Tool
---

# Install the Datadog Agent Integration Developer Tool

This document covers how to setup a Python environment to work on Agent-based Integrations, including installing the interpreter and developer tool.

## Install Python{% #install-python %}

Many operating systems come with a pre-installed version of Python. However, the version of Python installed by default may not be the same as the one used by the latest Agent. To ensure that you have everything you need to get an integration running, install a dedicated Python interpreter.

{% tab title="MacOS" %}
Install Python 3.13 using [Homebrew](https://brew.sh/):

1. Update Homebrew:

   ```
   brew update
   ```

1. Install Python:

   ```
   brew install python@3.13
   ```

1. Check the Homebrew installation output and run any additional commands recommended by the installation script.

1. Verify that the Python binary is installed in your `PATH` and that have installed the correct version:

   ```
   which python3.13
   ```

You should see the following output depending on your Mac architecture:

   - ARM (M1+) machines:
     ```
     /opt/homebrew/bin/python3.13
     ```
   - MacOS on Intel machines:
     ```
     /usr/local/bin/python3.13
     ```

{% /tab %}

{% tab title="Windows" %}

1. Download the [Python 3.13 64-bit executable installer](https://www.python.org/downloads/release/python-3115/) and run it.
1. Select the option to add Python to your PATH.
1. Click **Install Now**.
1. After the installation has completed, restart your machine.
1. Verify that the Python binary is installed in your `PATH`:
   ```
   > where python
   
   C:\Users\<USER>\AppData\Local\Programs\Python\Python39\python.exe
   ```

{% /tab %}

{% tab title="Linux" %}
For Linux installations, avoid modifying your system Python. Datadog recommends installing Python 3.13 using [pyenv](https://github.com/pyenv/pyenv#automatic-installer) or [miniconda](https://conda.io/projects/conda/en/stable/user-guide/install/linux.html).
{% /tab %}

## Install developer tooling{% #install-developer-tooling %}

You have 2 options to install the `ddev` CLI.

### Install using a GUI{% #install-using-a-gui %}

{% tab title="MacOS" %}

1. In your browser, download the `.pkg` file: [ddev-14.3.0.pkg](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0.pkg)
1. Run your downloaded file and follow the on-screen instructions.
1. Restart your terminal.
1. To verify that the `ddev` command has been added to your `PATH`, run the following command to retrieve the `ddev` version:
   ```shell
   ddev --version
   14.3.0
   ```

{% /tab %}

{% tab title="Windows" %}

1. In your browser, download one of the following `.msi` files:
   - [ddev-14.3.0-x64.msi (64-bit)](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x64.msi)
   - [ddev-14.3.0-x86.msi (32-bit)](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86.msi)
1. Run your downloaded file and follow the on-screen instructions.
1. Restart your terminal.
1. To verify that the `ddev` command has been added to your `PATH`, run the following command to retrieve the `ddev` version:
   ```shell
   ddev --version
   14.3.0
   ```

{% /tab %}

### Install from the command line{% #install-from-the-command-line %}

{% tab title="MacOS" %}

1. Download the file using the `curl` command. The -L option allows for redirects, and the -o option specifies the file name to which the downloaded package is written. In this example, the file is written to `ddev-14.3.0.pkg` in the current directory.
   ```shell
   curl -L -o ddev-14.3.0.pkg https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0.pkg
   ```
1. Run the standard macOS [`installer`](https://ss64.com/osx/installer.html) program, specifying the downloaded `.pkg` file as the source. Use the `-pkg` parameter to specify the name of the package to install, and the `-target /` parameter for the drive in which to install the package. The files are installed to `/usr/local/ddev`, and an entry is created at `/etc/paths.d/ddev` that instructs shells to add the `/usr/local/ddev` directory to. You must include `sudo` on the command to grant write permissions to those folders.
   ```shell
   sudo installer -pkg ./ddev-14.3.0.pkg -target /
   ```
1. Restart your terminal.
1. To verify that the shell can find and run the `ddev` command in your `PATH`, use the following command.
   ```shell
   ddev --version
   14.3.0
   ```

{% /tab %}

{% tab title="Windows" %}

1. Download and run the installer using the standard Windows [`msiexec`](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) program, specifying one of the `.msi` files as the source. Use the `/passive` and `/i` parameters to request an unattended, normal installation.
   - `x64`:
     ```shell
     msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x64.msi
     ```
   - `x86`:
     ```shell
     msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86.msi
     ```
1. Restart your terminal.
1. To verify that the shell can find and run the `ddev` command in your `PATH`, use the following command.
   ```shell
   ddev --version
   14.3.0
   ```

{% /tab %}

### Install from a standalone binary{% #install-from-a-standalone-binary %}

After downloading the archive corresponding to your platform and architecture, extract the binary to a directory that is on your `PATH` and rename the binary to `ddev`.

{% tab title="MacOS" %}

- [ddev-14.3.0-aarch64-apple-darwin.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-aarch64-apple-darwin.tar.gz)
- [ddev-14.3.0-x86_64-apple-darwin.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86_64-apple-darwin.tar.gz)

{% /tab %}

{% tab title="Windows" %}

- [ddev-14.3.0-x86_64-pc-windows-msvc.zip](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86_64-pc-windows-msvc.zip)
- [ddev-14.3.0-i686-pc-windows-msvc.zip](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-i686-pc-windows-msvc.zip)

{% /tab %}

{% tab title="Linux" %}

- [ddev-14.3.0-aarch64-unknown-linux-gnu.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-aarch64-unknown-linux-gnu.tar.gz)
- [ddev-14.3.0-x86_64-unknown-linux-gnu.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86_64-unknown-linux-gnu.tar.gz)
- [ddev-14.3.0-x86_64-unknown-linux-musl.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-x86_64-unknown-linux-musl.tar.gz)
- [ddev-14.3.0-i686-unknown-linux-gnu.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-i686-unknown-linux-gnu.tar.gz)
- [ddev-14.3.0-powerpc64le-unknown-linux-gnu.tar.gz](https://github.com/DataDog/integrations-core/releases/download/ddev-v14.3.0/ddev-14.3.0-powerpc64le-unknown-linux-gnu.tar.gz)

{% /tab %}