---
id: pyjoulescope-driver
version: "2.4.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pyjoulescope-driver — Joulescope™ driver

License: permissive · Maintenance: active · Downloads: 259.6K/mo

## What it is and what it does

pyjoulescope_driver is a Python interface to the Joulescope hardware driver, a second-generation C library that communicates with Joulescope precision DC energy analyzers. It supports three device models (JS110, JS220, JS320) and provides command-line tools for scanning and querying connected devices. The package is built on a modern event-driven PubSub architecture designed for easier integration with user interfaces and other software packages, replacing an earlier Python-only driver from 2019.

The package depends on numpy, psutil, pywin32, and requests. It is distributed as pre-compiled wheels for Python 3.12, 3.13, and 3.14 across macOS (universal2), Linux (aarch64, x86_64), and Windows (amd64, arm64) platforms. Installation is straightforward via pip, though Linux users must install udev rules separately to access the device, and source builds require CMake and a C++ toolchain.

Use it for:

- Measure and log DC power consumption of embedded systems or hardware prototypes during development and testing
- Automate energy profiling of devices in CI/CD pipelines to detect power regressions
- Build custom monitoring dashboards or data analysis scripts around Joulescope hardware measurements
- Integrate Joulescope measurements into larger test automation or hardware characterization workflows

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python bindings for the Joulescope DC energy analyzer driver, enabling communication with JS110, JS220, and JS320 Joulescope devices to configure operation and receive measurement data.

Yes, if you own or plan to use a Joulescope device (JS110, JS220, or JS320). The package is actively maintained, has no known vulnerabilities, uses a permissive license, and provides both command-line and programmatic access to the hardware. Install friction is moderate but manageable for the target audience. Not relevant for users without Joulescope hardware.

## Install

pip install pyjoulescope-driver
uv add pyjoulescope-driver
poetry add pyjoulescope-driver

## Installing pyjoulescope-driver

Before you install: Medium install friction due to compiled wheels for multiple platforms and Python versions (3.12–3.14). Active maintenance with a release 10 days old. Requires development tools (CMake, build toolchain) if building from source; pre-built wheels available for macOS, Linux, and Windows. On Linux, udev rules installation is necessary for device access.

License in practice: Apache-2.0 permissive license allows commercial and private use, modification, and redistribution with attribution and liability disclaimer. No restrictions on downstream licensing.

Quickstart:

pip install pyjoulescope_driver

import pyjoulescope_driver

# Command-line entry points available:
# python -m pyjoulescope_driver scan
# python -m pyjoulescope_driver info

Requires Python 3.12 or later. On Linux, udev rules must be installed for device access. On Windows, may require Microsoft C++ Build Tools if building from source.

Verify before relying:

- Whether the package provides a programmatic API beyond command-line tools for real-time data streaming and device configuration
- Performance characteristics and data throughput rates for the supported Joulescope models
- Whether PubSub event-driven API mentioned in description is directly exposed to Python users

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 259.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

joulescope driver python, DC energy analyzer, power measurement hardware, joulescope device control, USB energy measurement, precision power analyzer, hardware device driver, hardware-driver, power-measurement, embedded-systems

[View on SkillFed](https://skillfed.io/packages/pyjoulescope-driver) · [View on PyPI](https://pypi.org/project/pyjoulescope-driver/)