---
id: genicam
version: "1.5.1"
license: The GenICam License Version 1.6
license_treatment: unclear
maintenance: aging
---

# genicam — The official Python Binding for the GenICam GenApi & the GenTL Producers

License: unclear · Maintenance: aging · Downloads: 97.0K/mo

## What it is and what it does

genicam is the official Python binding for GenICam, a standardized interface for controlling industrial imaging devices and GenTL producers. It exposes two main submodules: genapi for reading and writing GenICam feature nodes from device description files (XML, ZIP, or string), and gentl for controlling GenTL Producer functionality. The package is a thin wrapper around the GenICam standard, allowing you to instantiate a NodeMap, load a device description, and then interact with device features by name—reading integer, boolean, enumeration, string, and command nodes.

The package has no runtime dependencies and ships as compiled wheels for multiple Python versions on Linux and Windows. It is maintained by the GenICam committee and marked Production/Stable, though the last release was 276 days ago and maintenance status is aging. The gentl submodule is not yet documented, suggesting partial feature completeness.

Use it for:

- Control industrial cameras and imaging devices that expose GenICam feature nodes via XML device description files.
- Read and write device parameters by name without manual protocol handling.
- Automate device configuration in machine vision and scientific imaging workflows.
- Integrate GenICam-compliant hardware into Python-based automation or data acquisition pipelines.
- Parse and validate GenICam device descriptions packaged as XML or ZIP archives.

## Worth the install?

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

Provides Python bindings to GenICam, enabling control of GenICam-compliant devices and GenTL producers through the genapi and gentl submodules.

Yes, if you are working with GenICam-compliant industrial imaging hardware and need a Python interface. The package is official, stable, and dependency-free. However, verify that your device ships with a GenICam description file and that the gentl submodule meets your needs (it is not yet documented). The unclear license and aging maintenance warrant review before use in commercial or redistributed projects.

## Install

pip install genicam
uv add genicam
poetry add genicam

## Installing genicam

Before you install: Medium install friction due to compiled wheels for multiple Python versions and architectures. No runtime dependencies simplifies the environment. Last release 276 days ago; maintenance status is aging.

License in practice: Licensed under 'The GenICam License Version 1.6' with unclear treatment—not an SPDX-recognized open-source license. Review the license terms before use in proprietary or redistributed projects.

Quickstart:

from genicam.genapi import NodeMap

node_map = NodeMap()
node_map.load_xml_from_file('device_description.xml')
node_map.Foo.value = 42

Requires a GenICam-compliant device or a valid device description XML file to be useful; the module itself is a binding layer with no built-in test data.

Verify before relying:

- Whether gentl submodule is fully implemented or still under development (description notes '[TO BE DOCUMENTED]').
- Specific Python version support; requires_python is unspecified in metadata.
- Whether the package works on macOS despite it being listed in classifiers.

## Package facts

- License: The GenICam License Version 1.6 (unclear)
- Python support: unspecified
- Install friction: medium
- Maintenance: aging
- Downloads: 97.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

genicam python binding, genapi device control, gentl producer interface, industrial camera control, genicam node map, device feature control, genapi xml configuration, industrial-imaging, device-control, hardware-interface

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