Metadata-Version: 2.1
Name: lumeo
Version: 0.1.2
Summary: Helper library for Lumeo video analytics platform
Home-page: https://github.com/lumeohq/lumeo-python/
Author: Lumeo
Author-email: support@lumeo.com
License: MIT
Project-URL: Documentation, https://docs.lumeo.com/
Platform: any
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
License-File: LICENSE.txt
Requires-Dist: importlib-metadata; python_version < "3.8"
Requires-Dist: httpx>=0.27
Requires-Dist: backoff>=2.2
Requires-Dist: boto3>=1.34
Requires-Dist: aiocache>=0.12
Requires-Dist: aiofiles>=23.2
Requires-Dist: anyio>=4.3
Requires-Dist: asyncio>=3.4
Requires-Dist: colorlog>=6.8
Requires-Dist: requests>=2.31
Requires-Dist: argparse>=1.4
Provides-Extra: testing
Requires-Dist: setuptools; extra == "testing"
Requires-Dist: pytest; extra == "testing"
Requires-Dist: pytest-cov; extra == "testing"

<!-- These are examples of badges you might want to add to your README:
     please update the URLs accordingly

[![Built Status](https://api.cirrus-ci.com/github/<USER>/lumeo.svg?branch=main)](https://cirrus-ci.com/github/<USER>/lumeo)
[![ReadTheDocs](https://readthedocs.org/projects/lumeo/badge/?version=latest)](https://lumeo.readthedocs.io/en/stable/)
[![Coveralls](https://img.shields.io/coveralls/github/<USER>/lumeo/main.svg)](https://coveralls.io/r/<USER>/lumeo)
[![PyPI-Server](https://img.shields.io/pypi/v/lumeo.svg)](https://pypi.org/project/lumeo/)
[![Conda-Forge](https://img.shields.io/conda/vn/conda-forge/lumeo.svg)](https://anaconda.org/conda-forge/lumeo)
[![Monthly Downloads](https://pepy.tech/badge/lumeo/month)](https://pepy.tech/project/lumeo)
[![Twitter](https://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Twitter)](https://twitter.com/lumeo)
-->
# lumeo

>Helper library for Lumeo video analytics platform

Lumeo is a flexible, open no/low code video analytics platform that enables you to generate actionable insights and alerts using AI-based video analytics.
This package provides :
1) a set of helpers to be used within Lumeo's [custom function node](https://docs.lumeo.com/docs/custom-function-node)
2) a set of scripts that make it easy to use Lumeo's API for importing cameras, bulk processing video, etc.

## Useful Links

- [Lumeo](https://lumeo.com/)
- [Lumeo Documentation Hub](https://docs.lumeo.com/)
- [API Reference](https://docs.lumeo.com/reference)


## Lumeo Custom Function Node install & usage

From within a Lumeo [custom function node](https://docs.lumeo.com/docs/custom-function-node), you install and use the package as follows:

```python
# This code will only work within a Lumeo custom function node.
from lumeopipeline import VideoFrame, Utils

# Replace version x.x.x with the version you want to install
lumeo = Utils.install_import('lumeo', version='x.x.x')
from lumeo.pipeline.display import write_label_on_frame

def process_frame(frame: VideoFrame, **kwargs):
     with frame.data() as mat:
         write_label_on_frame(mat, 50, 50, 'hello world')
     return True
```  

> Note that `lumeo.pipeline`'s submodules are not usable outside of a Lumeo custom function node.

Refer to Lumeo docs for details on available helpers and methods.



## Local install & usage

You can install the package locally to use the scripts that it provides.

### Install

```bash
pip install lumeo
```

```bash
pip install lumeo==x.x.x
```

### Scripts

See list of available scripts:

```bash
lumeo-scripts
```

