PyHikRobot provides zero-copy Python bindings for Hikrobot machine-vision cameras via the MVS SDK, featuring NumPy views, cross-platform support, and a rich error hierarchy.

Stars

6

7-day growth

No data

Forks

0

Open issues

0

License

Apache-2.0

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It offers a deliberately designed API that prevents common buffer-lifecycle bugs by releasing frames automatically and raising errors on stale accesses, while maintaining performance through zero-copy views.

Who it is for

  • Python developers integrating Hikrobot cameras into machine vision applications
  • Industrial automation engineers needing real-time camera control and stream processing
  • Researchers and hobbyists working with GigE or USB vision cameras in Python

Use cases

  • Capture and process live video frames in NumPy without copying data
  • Configure camera parameters (exposure, gain, pixel format) via named properties or GenICam node map
  • Tune GigE transport settings (packet size, resend) to ensure reliable streaming
  • Gracefully handle camera errors (network issues, buffer exhaustion, access conflicts) with specific exception classes

Strengths

  • Zero-copy NumPy views avoid unnecessary memory copies for high-throughput frame processing
  • Explicit frame-release mechanism (`.copy()` or `frames_raw()`) prevents accidental buffer reuse bugs
  • Cross-platform support (Linux x86_64/aarch64/armv7l, Windows x64) and lazy SDK loading
  • Comprehensive error hierarchy with over 20 specific exception types, including status codes for untranslated errors

Considerations

  • Alpha status: public API may change, and Action Commands and CUDA layer are not yet implemented
  • Requires separate installation of Hikrobot MVS SDK (not bundled) and thus vendor-specific licensing
  • Buffer lifecycle rules require careful coding: a retained NumPy view can silently return outdated pixel data

README quick start

Quick start

Description

Thin, zero-copy Python bindings for Hikrobot machine-vision cameras (MVS SDK). NumPy views without the copy, cross-platform loader, sane errors.

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482