Query the physical world
like a database.

# Create a project, upload media, run a search
percept project create warehouse-demo
percept stream create dock-cam-4 \
  --type rtsp --url rtsp://camera.local/stream \
  --tier hot --retention 72h

percept search "person carrying package into loading dock" \
  --project warehouse-demo \
  --since 24h \
  --evidence

from perceptdb import Client

db = Client(api_key="...")

results = db.search(
    project="warehouse-demo",
    query="package delivered and door left open",
    sources=["dock-cam-4"],
    since="24h",
    evidence=True,
)

for hit in results:
    print(hit.event_type, hit.confidence, hit.clip_url)

import { Percept } from "@perceptdb/sdk";

const percept = new Percept({ apiKey: process.env.PERCEPT_KEY });

const results = await percept.search({
  query: "person in red hoodie entering loading dock",
  project: "warehouse-demo",
  since: "7d",
  evidence: true,
});

SELECT
  p.delivery_id,
  p.delivered_at,
  d.duration_seconds AS door_open_duration,
  p.evidence_clip
FROM package_events p
JOIN door_open_events d
  ON p.camera_id = d.camera_id
WHERE d.start_time BETWEEN p.delivered_at AND p.delivered_at + INTERVAL '5 minutes'
  AND d.duration_seconds > 300
  AND VECTOR_MATCH(p.embedding, 'package on doorstep') > 0.82;