alpha-sdk-client 0.3.1

Python client for the Alpha Camera REST API — control Sony cameras via REST.

alpha-sdk-client

Python client for the Alpha Camera REST API.

Install (local development)

pip install -e .

Run the notebook example

If you want the standalone public example repo instead of the in-repo helper, use:

• alpha-sdk-python

Start the camera server first, then from sdks/python/ install the SDK in editable mode:

cd sdks/python
pip install -e .

You can sanity-check the example script directly:

python examples/notebook_data_collection.py

That file is primarily intended to be imported from Jupyter or another notebook environment.

If you want to use it in Jupyter:

cd sdks/python
python -m pip install jupyter
jupyter notebook

Then in a notebook cell:

import sys
from pathlib import Path

sys.path.append(str(Path("examples").resolve()))

from alpha_sdk_client import AlphaSDKClient
from notebook_data_collection import (
    collect_property_rows,
    connect_first_camera,
    enable_live_view,
    fetch_live_view_frame,
    save_live_view_frame,
)

client = AlphaSDKClient(base_url="http://localhost:8080")
camera = connect_first_camera(client, mode="remote")
rows = collect_property_rows(client, camera.id, count=5, interval_s=1.0)

Usage

from alpha_sdk_client import AlphaSDKClient

client = AlphaSDKClient(base_url="http://localhost:8080")
cameras = client.cameras.list()
print(cameras.cameras)

Async

from alpha_sdk_client import AsyncAlphaSDKClient

client = AsyncAlphaSDKClient(base_url="http://localhost:8080")
cameras = await client.cameras.list()

Notebook / data collection example

For a minimal Jupyter-friendly workflow, use:

• sdks/python/examples/notebook_data_collection.py

Standalone public example repo:

• alpha-sdk-python

It covers the common data-science path:

• discover and connect to the first camera
• collect repeated property snapshots into row dictionaries
• trigger AF capture
• fetch and save a live-view JPEG frame
• preview SD card files in remote-transfer mode

Typical notebook usage:

from alpha_sdk_client import AlphaSDKClient
from notebook_data_collection import (
    collect_property_rows,
    connect_first_camera,
    enable_live_view,
    fetch_live_view_frame,
    save_live_view_frame,
)

client = AlphaSDKClient(base_url="http://localhost:8080")
camera = connect_first_camera(client, mode="remote")

rows = collect_property_rows(client, camera.id, count=5, interval_s=1.0)

enable_live_view(client, camera.id)
frame = fetch_live_view_frame(client, camera.id)
save_live_view_frame(frame, "frame.jpg")

If you want a pandas DataFrame, the helper already returns plain row dictionaries:

import pandas as pd

df = pd.DataFrame(rows)
df.head()

Recipes — SSE, live view, server lifecycle, discovery

This SDK covers every REST endpoint. For the patterns that aren't REST (real-time events, frame polling, spawning the server) use the copy-paste recipes on crsdk.app:

Pattern	Recipe
Real-time events (SSE)	SSE events
Live view frame polling	Live view polling
Server subprocess lifecycle	Server subprocess
Camera discovery / hot-plug	Discovery + reconnect
Retry with backoff	Retry + backoff