Installation

This page covers the installation of DipDup in different environments.

Host requirements

A Linux/macOS environment with Python 3.12 installed is required to use DipDup. Also, you need a basic Python environment for the install script, python3.12 -m ensurepip. Apple silicon is supported. Other UNIX-like systems should work but are not supported officially. If you use Windows, please use WSL or Docker.

Minimum hardware requirements are 256 MB RAM, 1 CPU core, and some disk space for the database. RAM requirements increase with the number of indexes.

Local installation

As a CLI application

The easiest way to install DipDup is to use our interactive installer script. It will ask you a few questions and install DipDup with all dependencies. Run the following command in your terminal:

curl -Lsf https://dipdup.io/install.py | python3

That's it! DipDup is installed as a CLI application and is available everywhere in a system. Now you can run dipdup new to spawn a new project from lots of ready-to-use templates and proceed to the next section: Core concepts

This script performs some basic checks, installs uv for the current user, and then installs DipDup with uv. But it's always better to read the code before running it. To do so, curl -Lsf https://dev.dipdup.io/install.py | tee /tmp/install.py, review the script, then run it with python3 /tmp/install.py to proceed.

As a library

DipDup projects use uv to manage dependencies and virtual environments. See the pyproject.toml file in the project root for details and README.md for instructions.

To install DipDup in a just created project run:

make install
source .venv/bin/activate

If you prefer to use other package manager, edit configs/replay.yaml file and run dipdup init --force.

Docker

For Docker installation, please refer to the Docker page.