Installation

pydoover requires Python 3.11 or later. It has two core dependencies --- aiohttp (async HTTP) and httpx (sync HTTP) --- which are installed automatically.

The recommended way to install pydoover is from PyPI.

Using pip:

pip install pydoover

Using uv:

uv add pydoover

To install the latest development version directly from GitHub:

pip install git+https://github.com/getdoover/pydoover.git

This is useful when you need a fix or feature that has not yet been published to PyPI.

pydoover ships optional dependency groups for specific use cases. Install them by appending the extra name in brackets.

Device-side applications communicate with the Doover Device Agent, Platform I/O, and Modbus services over gRPC. Install the grpc extra to pull in grpcio and protobuf:

pip install pydoover[grpc]

The report processor framework uses croniter for schedule parsing. Install the reports extra to enable it:

pip install pydoover[reports]

You can install multiple extras at once:

pip install pydoover[grpc,reports]

Doovit devices can install pydoover from the Doover apt repository at apt.doover.com. This is the standard installation method for production edge deployments and is handled automatically by the Doover device provisioning process.

After installing, confirm that pydoover is available and check the installed version:

python -c "import pydoover; print(pydoover.__version__)"

You should see output like 1.0.0a13 (the exact version will depend on your install).

The doover CLI is a companion command-line tool that wraps pydoover and provides commands for managing applications, devices, channels, and more. Install it separately:

pip install doover-cli

See the Doover CLI Overview for usage details.

With pydoover installed, head to the Quick Start guide to build your first application.