---
title: HomeKit Secure Video Analysis
framework: Private Cloud Compute Security Guide
role: article
role_heading: Article
path: private-cloud-compute/hksvanalysis
---

# HomeKit Secure Video Analysis

PCC generates natural-language descriptions and embeddings for the video clips that a user’s home hub submits.

## Overview

Overview This workflow brings cloud analysis to a user’s HomeKit Secure Video (HKSV) clips; its HKSVProcessingAgent is a PCC Agent workflow that runs video analysis on behalf of the user’s home. It produces natural-language video descriptions and embeddings that the Home app then uses to summarize clip activity, run free-form semantic search across the user’s video library, and coalesce notifications. The user’s home hub triggers processing: it receives the clip from the HomeKit camera and submits the encrypted video fragments to PCC inside the request body for decoding and analysis. PCC processes only the encrypted fragments the home hub submits in the request; it does not retrieve clips or fragments from any other store. Workflow inputs The home hub initiates processing by sending a request to the HKSVProcessingAgent workflow. The request carries three kinds of input: Processing options carried in the request select an operating mode (such as EmbeddingOnly to skip generating descriptions entirely, or a histogram-reuse mode driven by a HistogramReuseClipID that refers to a prior clip whose analysis the device reuses rather than recomputes), a similarity threshold for the gating step, and a client locale that selects the description prompt language. Workflow execution Following the PCC Agent workflows, HKSVProcessingAgent runs a static, four-stage pipeline on an PCC Agent, issuing Delegated tool calls to other PCC nodes for three of those stages: After generating the descriptions, the workflow assembles an HKSVResult that contains the embeddings, the video descriptions, and per-stage timing metadata, and returns this result to the home hub. tip: To run this pipeline across agent, decoder, embedding, and inference instances in the VRE, follow Exercise HomeKit Secure Video Analysis.