alphadeep-capture 0.1.2

AlphaDeep Live Capture Tool

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:

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

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:

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.