Metadata-Version: 2.1
Name: idatagate
Version: 0.0.3
Summary: Package for collecting data and transforming to dataset
Author: Popis
Author-email: piotrpopis98@icloud.com
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: cryptography (>=43.0.0,<44.0.0)
Requires-Dist: google-api-python-client (>=2.142.0,<3.0.0)
Requires-Dist: google-auth (>=2.34.0,<3.0.0)
Requires-Dist: google-auth-httplib2 (>=0.2.0,<0.3.0)
Requires-Dist: google-auth-oauthlib (>=1.2.1,<2.0.0)
Requires-Dist: mediapipe (>=0.10.14)
Requires-Dist: numpy (>=2.0.0,<3.0.0)
Requires-Dist: opencv-python (>=4.10.0.84)
Requires-Dist: tabulate (>=0.9.0,<0.10.0)
Requires-Dist: typer (>=0.12.4,<0.13.0)
Description-Content-Type: text/markdown

# idatagate

`idatagate` is a CLI tool designed for managing and processing hand image datasets, as well as uploading files to Google Storage. It allows you to collect images, transform them into datasets, and manage files in Google Drive storage efficiently.

## Table Of Contents

- [idatagate](#idatagate)
  - [Table Of Contents](#table-of-contents)
  - [Features](#features)
  - [Installation](#installation)
  - [Usage](#usage)
    - [Collecting Hand Images](#collecting-hand-images)
      - [Example Command](#example-command)
    - [Uploading Files](#uploading-files)
    - [Listing Files](#listing-files)
    - [Downloading Files](#downloading-files)
    - [Instruction](#instruction)
    - [Caching the Encryption Key](#caching-the-encryption-key)
  - [Contributing](#contributing)
  - [License](#license)

## Features

- **Collect hand images** with real-time landmark detection for multiple classes.
- **Upload files** to Google Storage.
- **Download files** or list files from Google Storage.

## Installation

To install `idatagate`, run:

```bash
pipx install idatagate
```

## Usage

### Collecting Hand Images

To collect images, run:

```bash
idatagate collect --data-dir /path/to/save/images --classes-number 26 --samples-number 100
```

The command will take images for 26 different classes (such as the alphabet in sign language) and store them in the specified directory. Each class will have by default 100 images collected using landmark detection.
The collection will continue until all images are gathered for each class.
The image collection uses real-time landmark detection to capture high-quality images. For reference, the classes are aligned with the alphabet as demonstrated in this example image:

![img](https://github.com/sqoshi/idatagate/raw/master/idatagate/assets/alphabet.png)

#### Example Command

```bash
idatagate collect --data-dir ./images --classes-number 26 --samples-number 100
```

This command will continuously capture images for 26 classes (each corresponding to a letter of the alphabet) until 100 samples per class are collected.

### Uploading Files

To upload a zip file to Google Storage, use:

```bash
idatagate upload --key <API_KEY>
```

Make sure the key is already set before running the upload command. If the key is not set, use the idatagate set-key command as described earlier.

### Listing Files

To list files in Google Storage, use:

```bash
idatagate list
```

### Downloading Files

To download a file from Google Storage, you can specify a file ID:

```bash
idatagate download --file-id <FILE_ID>
```

Or download all files:

```bash
idatagate download
```

### Instruction

Firsly collect the data with

```bash
idatagate collect
```

then upload files to server:

```bash
idatagate upload
```

### Caching the Encryption Key

It is possible


## Contributing

Feel free to open issues or contribute by submitting pull requests.

## License

This project is licensed under the MIT License.

