Metadata-Version: 2.1
Name: pycoral
Version: 2.0.0
Summary: Coral Python API
Home-page: https://github.com/google-coral/pycoral
Author: Coral
Author-email: coral-support@google.com
License: Apache 2
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Mathematics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.5.2
Description-Content-Type: text/markdown
Requires-Dist: numpy (>=1.16.0)
Requires-Dist: Pillow (>=4.0.0)
Requires-Dist: tflite-runtime (==2.5.0.post1)

# PyCoral API

This repository contains an easy-to-use Python API that helps you run inferences
and perform on-device transfer learning with TensorFlow Lite models on
[Coral devices](https://coral.ai/products/).

To install the prebuilt PyCoral library, see the instructions at
[coral.ai/software/](https://coral.ai/software/#pycoral-api).

**Note:** If you're on a Debian system, be sure to install this library from
apt-get and not from pip. Using `pip install` is not guaranteed compatible with
the other Coral libraries that you must install from apt-get. For details, see
[coral.ai/software/](https://coral.ai/software/#debian-packages).

## Documentation and examples

To learn more about how to use the PyCoral API, see our guide to [Run inference
on the Edge TPU with Python](https://coral.ai/docs/edgetpu/tflite-python/) and
check out the [PyCoral API reference](https://coral.ai/docs/reference/py/).

Several Python examples are available in the `examples/` directory. For
instructions, see the [examples README](
https://github.com/google-coral/pycoral/tree/master/examples#pycoral-api-examples).


## Compilation

When building this library yourself, it's critical that you have
version-matching builds of
[libcoral](https://github.com/google-coral/libcoral/tree/master) and
[libedgetpu](https://github.com/google-coral/libedgetpu/tree/master)—notice
these are submodules of the pycoral repo, and they all share the same
`TENSORFLOW_COMMIT` value. So just be sure if you change one, you must change
them all.

For complete details about how to build all these libraries, read
[Build Coral for your platform](https://coral.ai/docs/notes/build-coral/).
Or to build just this library, follow these steps:

1.  Clone this repo and include submodules:

    ```
    git clone --recurse-submodules https://github.com/google-coral/pycoral
    ```

    If you already cloned without the submodules. You can add them with this:

    ```
    cd pycoral

    git submodule init && git submodule update
    ```

1.  Run `scripts/build.sh` to build pybind11-based native layer for different
    Linux architectures. Build is Docker-based, so you need to have it
    installed.

1.  Run `make wheel` to generate Python library wheel and then `pip3 install
    $(ls dist/*.whl)` to install it


