Metadata-Version: 2.4
Name: alphadeep-capture
Version: 0.1.3
Summary: AlphaDeep Live Capture Tool
Author-email: "AlphaDeep Inc." <nmilosev@alphadeep.ai>
License: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: numpy>=1.24.0
Requires-Dist: opencv-python>=4.8.0
Requires-Dist: pygame>=2.5.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# AlphaDeep Capture

AlphaDeep Capture is a high-performance Python/Pygame application designed for live streaming, data capture, and realtime cloud-inference using the AlphaDeep AI platform.

## Installation

This project is built using modern Python tooling and can be installed locally via `pip` or `uv`:

```bash
git clone <repository_url>
cd alphadeep-capture

# Install the application and all dependencies
uv pip install -e .
```

## Configuration

AlphaDeep Capture uses a YAML configuration file stored in your user configuration directory (following the XDG Base Directory standard). 

**Configuration Path**: `~/.config/alphadeep/capture/config.yaml`

If this file does not exist when the app is first launched, a default configuration will be automatically generated. 

### Example `config.yaml`
```yaml
cameras:
  - id: 0
    name: Camera 1
  - id: 1
    name: Camera 2

fps: 30
samples_dir: ~/alphadeep_samples

# AlphaDeep API Configuration
alphadeep_session: "your_session_id"
alphadeep_adapter: "zero_adapter"
alphadeep_task: "detection"
alphadeep_api_key: "your_api_key_here"
alphadeep_classes: 
  - "car"
  - "person"
alphadeep_workers: 4

# Enable verbose console output for debugging API responses
debug: true
```

### Adding Your API Key
In order to use the **Analyze** functionality, you must edit your `config.yaml` and provide your `alphadeep_api_key`, `alphadeep_session`, and `alphadeep_task`.

## Running the Application

Once installed, you can launch the application directly from your terminal:

```bash
alphadeep-capture
```

## Features and Controls

* **New Sample**: Creates a fresh timestamped directory in your `samples_dir` for saving data.
* **Capture**: Instantly grabs the current frame from all active cameras and saves them as `.jpg` files in the current sample directory.
* **Preview Sample**: Opens an interactive gallery overlay to view all images captured in the current sample.
* **Analyze**: Sends the currently captured sample to the AlphaDeep API for remote inference and overlays the bounding box results in the UI.
* **Comment**: Opens a dialog to attach text notes to the current sample (saved as `comment.txt`).
* **Sync (Cloud)**: Placeholder feature for synchronizing samples with AlphaDeep cloud storage.
