Metadata-Version: 2.1
Name: dtlpy
Version: 1.111.11
Summary: SDK and CLI for Dataloop platform
Home-page: https://github.com/dataloop-ai/dtlpy
Author: Dataloop Team
Author-email: info@dataloop.ai
License: Apache License 2.0
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3 (>=1.26)
Requires-Dist: tqdm (>=4.63)
Requires-Dist: certifi (>=2020.12.5)
Requires-Dist: webvtt-py (==0.4.3)
Requires-Dist: aiohttp (>=3.8)
Requires-Dist: requests-toolbelt (>=1.0.0)
Requires-Dist: requests (>=2.25.0)
Requires-Dist: numpy (>=1.16.2)
Requires-Dist: pandas (>=0.24.2)
Requires-Dist: tabulate (>=0.8.9)
Requires-Dist: Pillow (>=7.2)
Requires-Dist: PyJWT (>=2.4)
Requires-Dist: jinja2 (>=2.11.3)
Requires-Dist: attrs (<=22.2.0)
Requires-Dist: prompt-toolkit (>=2.0.9)
Requires-Dist: fuzzyfinder (<=2.1.0)
Requires-Dist: dictdiffer (>=0.8.1)
Requires-Dist: validators (<=0.18.2)
Requires-Dist: pathspec (>=0.8.1)
Requires-Dist: filelock (>=3.0.12)
Requires-Dist: diskcache (>=5.4)
Requires-Dist: redis (>=3.5)
Requires-Dist: inquirer
Requires-Dist: dtlpymetrics
Requires-Dist: dataclasses

# **DTLPY – SDK and CLI for Dataloop.ai**

![logo.svg](docs%2F_static%2Flogo.svg)

[![Documentation Status](https://readthedocs.org/projects/dtlpy/badge/?version=latest)](https://sdk-docs.dataloop.ai/en/latest/?badge=latest)
[![PyPI Version](https://img.shields.io/pypi/v/dtlpy.svg)](https://pypi.org/project/dtlpy/)
[![Python Versions](https://img.shields.io/pypi/pyversions/dtlpy.svg)](https://github.com/dataloop-ai/dtlpy)
[![License](https://img.shields.io/github/license/dataloop-ai/dtlpy.svg)](https://github.com/dataloop-ai/dtlpy/blob/master/LICENSE)
[![Downloads](https://static.pepy.tech/personalized-badge/dtlpy?period=total&units=international_system&left_color=grey&right_color=green&left_text=Downloads)](https://pepy.tech/project/dtlpy)

📚 [Platform Documentation](https://dataloop.ai/docs) | 📖 [SDK Documentation](https://console.dataloop.ai/sdk-docs/latest) | [Developer docs](https://developers.dataloop.ai/)

An open-source SDK and CLI toolkit to interact seamlessly with the [Dataloop.ai](https://dataloop.ai/) platform, providing powerful data management, annotation capabilities, and workflow automation.

---

## **Table of Contents**

- [Overview](#overview)
- [Installation](#installation)
- [Usage](#usage)
  - [SDK Usage](#sdk-usage)
  - [CLI Usage](#cli-usage)
- [Python Version Support](#python-version-support)
- [Development](#development)
- [Resources](#resources)
- [Contribution Guidelines](#contribution-guidelines)

---

## **Overview**

DTLPY provides a robust Python SDK and a powerful CLI, enabling developers and data scientists to automate tasks, manage datasets, annotations, and streamline workflows within the Dataloop platform.

---

## **Installation**

Install DTLPY directly from PyPI using pip:

```bash
pip install dtlpy
```

Alternatively, for the latest development version, install directly from GitHub:

```bash
pip install git+https://github.com/dataloop-ai/dtlpy.git
```

---

## **Usage**

### **SDK Usage**

Here's a basic example to get started with the DTLPY SDK:

```python
import dtlpy as dl

# Authenticate
dl.login()

# Access a project
project = dl.projects.get(project_name='your-project-name')

# Access dataset
dataset = project.datasets.get(dataset_name='your-dataset-name')
```

### **CLI Usage**

DTLPY also provides a convenient command-line interface:

```bash
dlp login
dlp projects ls
dlp datasets ls --project-name your-project-name
```

---

## **Python Version Support**

DTLPY supports multiple Python versions as follows:

| Python Version     | 3.11 | 3.10 | 3.9 | 3.8 | 3.7 | 3.6 | 3.5 |
|--------------------|------|------|-----|-----|-----|-----|-----|
| **dtlpy >= 1.99**  | ✅   | ✅   | ✅  | ✅  | ✅  | ❌  | ❌  |
| **dtlpy 1.76–1.98**| ✅   | ✅   | ✅  | ✅  | ✅  | ✅  | ❌  |
| **dtlpy >= 1.61**  | ❌   | ✅   | ✅  | ✅  | ✅  | ✅  | ❌  |
| **dtlpy 1.50–1.60**| ❌   | ❌   | ✅  | ✅  | ✅  | ✅  | ❌  |
| **dtlpy <= 1.49**  | ❌   | ❌   | ✅  | ✅  | ✅  | ✅  | ✅  |

---

## **Development**

To set up the development environment, clone the repository and install dependencies:

```bash
git clone https://github.com/dataloop-ai/dtlpy.git
cd dtlpy
pip install -r requirements.txt
```

## **Resources**

- [Dataloop Platform](https://console.dataloop.ai)
- [Full SDK Documentation](https://console.dataloop.ai/sdk-docs/latest)
- [Platform Documentation](https://dataloop.ai/docs)
- [SDK Examples and Tutorials](https://github.com/dataloop-ai/dtlpy-documentation)
- [Developer docs](https://developers.dataloop.ai/)

---

## **Contribution Guidelines**

We encourage contributions! Please ensure:

- Clear and descriptive commit messages
- Code follows existing formatting and conventions
- Comprehensive tests for new features or bug fixes
- Updates to documentation if relevant

Create pull requests for review. All contributions will be reviewed carefully and integrated accordingly.
