Metadata-Version: 2.1
Name: groundlight
Version: 0.7.5
Summary: Build computer vision systems from natural language with Groundlight
Home-page: https://www.groundlight.ai
License: MIT
Author: Groundlight AI
Author-email: support@groundlight.ai
Requires-Python: >=3.7.0,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: certifi (>=2021.10.8,<2022.0.0)
Requires-Dist: frozendict (>=2.3.2,<3.0.0)
Requires-Dist: pillow (>=9.0.0,<10.0.0)
Requires-Dist: pydantic (>=1.7.4,<2.0.0)
Requires-Dist: python-dateutil (>=2.8.2,<3.0.0)
Requires-Dist: requests (>=2.28.2,<3.0.0)
Requires-Dist: urllib3 (>=1.26.9,<2.0.0)
Description-Content-Type: text/markdown

# Groundlight Python SDK

Groundlight makes it simple to build reliable visual applications. Read the [full documentation here](https://code.groundlight.ai/python-sdk/).

## Computer Vision powered by Natural Language

```bash
pip install groundlight
```

Build a working computer vision system in just 5 lines of python:

```python
from groundlight import Groundlight

gl = Groundlight()
d = gl.get_or_create_detector(name="door", query="Is the door open?")
image_query = gl.submit_image_query(detector=d, image=jpeg_img)
print(f"The answer is {image_query.result}")
```

### How does it work?

Your images are first analyzed by machine learning (ML) models which are automatically trained on your data. If those models have high enough confidence, that's your answer. But if the models are unsure, then the images are progressively escalated to more resource-intensive analysis methods up to real-time human review. So what you get is a computer vision system that starts working right away without even needing to first gather and label a dataset. At first it will operate with high latency, because people need to review the image queries. But over time, the ML systems will learn and improve so queries come back faster with higher confidence.

_Note: The SDK is currently in "beta" phase. Interfaces are subject to change in future versions._

## Learn more

Some more resources you might like:

- [Code Documentation](https://code.groundlight.ai/)
- [Python SDK](https://pypi.org/project/groundlight/)
- [Company](https://www.groundlight.ai/)
- [Login to Groundlight](https://app.groundlight.ai/)

