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()          # NumPy (H, W) or (H, W, 3) uint8
        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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

viva_genicam-0.5.0.tar.gz (377.0 kB view details)

Uploaded Aug 26, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

viva_genicam-0.5.0-cp39-abi3-win_amd64.whl (2.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+Windows x86-64

viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl (2.5 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+manylinux: glibc 2.28+ x86-64

viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl (2.3 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+macOS 11.0+ ARM64

File details

Details for the file viva_genicam-0.5.0.tar.gz.

File metadata

Download URL: viva_genicam-0.5.0.tar.gz
Upload date: Aug 26, 2026
Size: 377.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for viva_genicam-0.5.0.tar.gz
Algorithm	Hash digest
SHA256	`aa1a38e3c6361137bf8db59166497b0c22c41e4d34c7299d749273ae6420b82f`
MD5	`fcd90e831c5212d9b9c35a2e1f1bb246`
BLAKE2b-256	`408d0fcf7e1285161c526b4b15a99df361599e745139c7ab89314bd7e111be23`

See more details on using hashes here.

Provenance

The following attestation bundles were made for viva_genicam-0.5.0.tar.gz:

Publisher: python.yml on VitalyVorobyev/viva-genicam

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: viva_genicam-0.5.0.tar.gz
- Subject digest: aa1a38e3c6361137bf8db59166497b0c22c41e4d34c7299d749273ae6420b82f
- Sigstore transparency entry: 2601376277
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: VitalyVorobyev/viva-genicam@16058cd25b9dfc917f97e2433411ce8a96309a83
- Branch / Tag: refs/tags/py-v0.5.0
- Owner: https://github.com/VitalyVorobyev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@16058cd25b9dfc917f97e2433411ce8a96309a83
- Trigger Event: push

File details

Details for the file viva_genicam-0.5.0-cp39-abi3-win_amd64.whl.

File metadata

Download URL: viva_genicam-0.5.0-cp39-abi3-win_amd64.whl
Upload date: Aug 26, 2026
Size: 2.3 MB
Tags: CPython 3.9+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for viva_genicam-0.5.0-cp39-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`aecec6109a595e14ac378a9fdfd60dfa16240908c253aaf53d9335351f29e858`
MD5	`21cb3d84dc24711e05dfecd086ef896a`
BLAKE2b-256	`172e622d43743d250edd418477812255ed28e020f1dcfddf499859373c87f1a3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for viva_genicam-0.5.0-cp39-abi3-win_amd64.whl:

Publisher: python.yml on VitalyVorobyev/viva-genicam

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: viva_genicam-0.5.0-cp39-abi3-win_amd64.whl
- Subject digest: aecec6109a595e14ac378a9fdfd60dfa16240908c253aaf53d9335351f29e858
- Sigstore transparency entry: 2601377157
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: VitalyVorobyev/viva-genicam@16058cd25b9dfc917f97e2433411ce8a96309a83
- Branch / Tag: refs/tags/py-v0.5.0
- Owner: https://github.com/VitalyVorobyev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@16058cd25b9dfc917f97e2433411ce8a96309a83
- Trigger Event: push

File details

Details for the file viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl.

File metadata

Download URL: viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl
Upload date: Aug 26, 2026
Size: 2.5 MB
Tags: CPython 3.9+, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`a48973e16c513d95dae6376ab025dfa62580ed8f827fdc604b4c8ce453f0d79f`
MD5	`3796bbf7a3a25800e31153af58881fb6`
BLAKE2b-256	`c88bec383946bca476a3bd3d85eaffc9e628f8070bac1b5cd49bed6f13817ddc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl:

Publisher: python.yml on VitalyVorobyev/viva-genicam

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: viva_genicam-0.5.0-cp39-abi3-manylinux_2_28_x86_64.whl
- Subject digest: a48973e16c513d95dae6376ab025dfa62580ed8f827fdc604b4c8ce453f0d79f
- Sigstore transparency entry: 2601377745
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: VitalyVorobyev/viva-genicam@16058cd25b9dfc917f97e2433411ce8a96309a83
- Branch / Tag: refs/tags/py-v0.5.0
- Owner: https://github.com/VitalyVorobyev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@16058cd25b9dfc917f97e2433411ce8a96309a83
- Trigger Event: push

File details

Details for the file viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl
Upload date: Aug 26, 2026
Size: 2.3 MB
Tags: CPython 3.9+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`43d31a2243465ed5bb2e09ab7e1099ec246687ed56e7b2ca655343effca18713`
MD5	`288e7388fb9835e7ea47a9b297bbe212`
BLAKE2b-256	`9a0d9ad611dc5f52d1de0712daac47bc20ced8ee94377c426739e73f806b4934`

See more details on using hashes here.

Provenance

The following attestation bundles were made for viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl:

Publisher: python.yml on VitalyVorobyev/viva-genicam

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: viva_genicam-0.5.0-cp39-abi3-macosx_11_0_arm64.whl
- Subject digest: 43d31a2243465ed5bb2e09ab7e1099ec246687ed56e7b2ca655343effca18713
- Sigstore transparency entry: 2601376576
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: VitalyVorobyev/viva-genicam@16058cd25b9dfc917f97e2433411ce8a96309a83
- Branch / Tag: refs/tags/py-v0.5.0
- Owner: https://github.com/VitalyVorobyev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python.yml@16058cd25b9dfc917f97e2433411ce8a96309a83
- Trigger Event: push