viva-genicam (Python)
Pure-Rust GenICam stack with Python bindings. Discover, control, and stream GigE Vision and USB3 Vision cameras from Python — no aravis, no C toolchain, just a wheel.
pip install viva-genicam
The install also provides viva-camctl, the diagnostic CLI, so
viva-camctl report --ip <CAMERA-IP> --out viva-report.txt works without a Rust
toolchain. It is the right thing to attach to a bug report.
import viva_genicam as vg
cams = vg.discover(timeout_ms=500)
cam = vg.connect_gige(cams[0])
print(cam.get("DeviceModelName"))
cam.set_exposure_time_us(10_000.0)
with cam.stream() as frames:
for frame in frames:
arr = frame.to_numpy() # shape and dtype follow the pixel format
print(frame.width, frame.height, frame.pixel_format)
break
See the documentation for the full API.
Build from source
uv venv .venv
uv pip install --python .venv/bin/python maturin numpy pytest
uv run --python .venv/bin/python maturin develop -m crates/viva-pygenicam/Cargo.toml
Licensing
The viva-genicam code is MIT-licensed. The binary wheel additionally
statically links libusb (LGPL-2.1-or-later) for
USB3 Vision support, so the package license is
MIT AND LGPL-2.1-or-later. See THIRD-PARTY-NOTICES.md (shipped in the
wheel and sdist) for details, including how to rebuild the native module
against a modified or system libusb per LGPL §6.
1 maintainer
Metadata
1 maintainer
Release files for viva-genicam 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| viva_genicam-0.7.0.tar.gz | 411.0 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| viva_genicam-0.7.0-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| viva_genicam-0.7.0-cp39-abi3-manylinux_2_28_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| viva_genicam-0.7.0-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 7.7 MB
Release files / viva_genicam-0.7.0.tar.gz
| Download URL | viva_genicam-0.7.0.tar.gz |
|---|---|
| Size | 411.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d35eac09b656eb066f0b53f80b33c86cb6f2aad469f389eadfb52626f357d171
|
|
BLAKE2b-256 checksum How to use checksums |
2ede9074ce02319f8962b03b88f0885e0dfe35877f2260cb22896ea6025c4dbd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / viva_genicam-0.7.0-cp39-abi3-win_amd64.whl
| Download URL | viva_genicam-0.7.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 2.3 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
fb18a872f14ecbf6c4628e7a4178ff5a0565c7c0fd7813f3f33543e78ca699fe
|
|
BLAKE2b-256 checksum How to use checksums |
5b7fe432508e907a9bfb21fd346744fedeb731f092db60ce0e968c29ca36d69f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / viva_genicam-0.7.0-cp39-abi3-manylinux_2_28_x86_64.whl
| Download URL | viva_genicam-0.7.0-cp39-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
610287e3f8eca9aad8aaf550570b90b1ebb873774222097710ef0f137b01baea
|
|
BLAKE2b-256 checksum How to use checksums |
89966ee66166bbc665364489604c5a9539ff44fb37060d26ede30b3d4b0f7b80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency logRelease files / viva_genicam-0.7.0-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | viva_genicam-0.7.0-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e4ae433120030ff8b993bd8088848fc812e6dddacf90ff727281a95b769daf3b
|
|
BLAKE2b-256 checksum How to use checksums |
63296446d71d94102de11e8b0d443551c22f4f067e2ba4645d56039a9f01dcd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.
Transparency log
