Python

Call EyePop from Python

The EyePop Python SDK calls the inference and data APIs from Python. Install it, set an API key, and run a Pop against an image, video, or stream.

pip install eyepop

Requires Python 3.12 or newer.

Your first prediction

from eyepop import EyePopSdk
from eyepop.worker.worker_types import InferenceComponent, Pop

pop = Pop(components=[
    InferenceComponent(ability="eyepop.person:latest")
])

with EyePopSdk.sync_worker(pop=pop) as endpoint:
    result = endpoint.upload("photo.jpg").predict()
    print(result)

upload() queues the file and predict() blocks until the result is ready. A single image yields one prediction; a video or multi-frame container yields one per frame, so call predict() in a loop until it returns None.

Pass the Pop when you open the session so EyePop can schedule the right compute before any media is processed.

Next steps

• Configuration — credentials and environment variables

• Running Inference — files, streams, URLs, video, and image groups

• Composable Pops — chain models into a pipeline

• Data Endpoint — datasets, VLM inference, and evaluation