.. _changelog_openmv_py_v1_0_3:

v1.0.3
======

v1.0.3 is the **initial release of the OpenMV Python package** — a host-side
Python library and the ``openmv`` command-line tool for talking to an OpenMV
Cam from your computer over the Camera Protocol V2. As the first release there
is nothing to migrate from; this entry summarizes what it shipped with.

.. contents:: On this page
   :backlinks: none
   :local:
   :depth: 1

Highlights
----------

- **The ``openmv`` CLI** — connect to a camera over its USB serial port and
  stream its live video to your desktop.
- **Run scripts on the camera** — push a ``.py`` script to the cam and run it
  from the command line.
- **Camera Protocol V2 library** — a Python implementation of the protocol for
  scripted, host-side control of a camera.
- **pip-installable** — ``pip install openmv``.

New features
------------

The ``openmv`` command-line tool:

- Stream live video from a connected camera (``--port``), with an adjustable
  preview scale (``--scale``).
- Run a script on the camera (``--script``).
- Benchmark protocol throughput (``--bench``).
- Load firmware ELF symbols so the profiler shows function names
  (``--firmware``).
- Quiet (``--quiet``) and verbose-debug (``--debug``) modes.

Breaking API changes
--------------------

None. v1.0.3 is the initial release — there is no prior version to break
compatibility with.