landingai 0.0.12

Helper library for interacting with Landing AI LandingLens

LandingLens code sample repository

This repository contains LandingLens development library and running examples showing how to integrate LandingLens on a variety of scenarios. All the examples show different ways to acquire images from multiple sources and techniques to process the results. Jupyter notebooks focus on ease of use while Python apps include more robust and complete examples.

example	description	language
Company logo identification	This notebook can run directly in Google collab using the web browser camera to detect Landing AI logo	Jupyter Notebook
Door monitoring for home automation	This notebook uses an object detection model to determine whether a door is open or closed. The notebook can acquire images directly from an RTSP camera	Jupyter Notebook
Streaming capture service	This application shows how to do continuous acquisition from an image sensor using RTSP.	Python application
Pixel coverage post-processing	This notebook demonstrates how to use a VisualPrompting model to analyze the area coverage of different types of land or structures on satellite images.	Jupyter Notebook

Install the library

pip install landingai

Quick Start

Run inference using your deployed inference endpoint at LandingAI:

• Install the library with the above command.
• Create a Predictor with your inference endpoint id, landing API key and secret.
• Call predict() with an image (in numpy array format).

from landingai.predict import Predictor
# Find your API key and secrets
endpoint_id = "FILL_YOUR_INFERENCE_ENDPOINT_ID"
api_key = "FILL_YOUR_API_KEY"
api_secret = "FILL_YOUR_API_SECRET"
# Load your image
image = ...
# Run inference
predictor = Predictor(endpoint_id, api_key, api_secret)
predictions = predictor.predict(image)

Visualize your inference results by overlaying the predictions on the input image and save it on disk:

from landingai.visualize import overlay_predictions
# continue the above example
predictions = predictor.predict(image)
image_with_preds = overlay_predictions(predictions, image)
image_with_preds.save("image.jpg")

Running examples locally

All the examples in this repo can be run locally.

Here is an example to show you how to run the rtsp-capture example locally in a shell environment:

NOTE: it's recommended to create a new Python virtual environment first.

1. Clone the repo to local: git clone https://github.com/landing-ai/landingai-python.git
2. Install the library: poetry install --with examples (NOTE: see below for how to install poetry)
3. Activate the virtual environment: poetry shell
4. Run: python landingai-python/examples/capture-service/run.py

Building the landingai library locally (for contributors)

Most of the time you won't need to build the library since it is included on this repository and also published to pypi.

But if you want to contribute to the repo, you can follow the below steps.

Prerequisite - Install poetry

landingai uses Poetry for packaging and dependency management. If you want to build it from source, you have to install Poetry first. Please follow the official guide to see all possible options.

For Linux, macOS, Windows (WSL):

curl -sSL https://install.python-poetry.org | python3 -

NOTE: you can switch to use a different Python version by specifying the python version:

curl -sSL https://install.python-poetry.org | python3.10 -

or run below command after you have installed poetry:

poetry env use 3.10

Install all the dependencies

poetry install --all-extras

Run tests

poetry run pytest tests/

Activate the virtualenv

poetry shell