Detection Stream Simulator
A synthetic detection wire — protobuf-shaped, frame-rate-controllable, dual-transport (gRPC + length-prefixed TCP) — so client-side integration work doesn't have to wait for the real perception pipeline.
What it is
A small server that pretends to be a real-time object detection service. It speaks the same protobuf contract that the production detection pipeline does, at a configurable frame rate, over two transports simultaneously: gRPC on one port, length-prefixed protobuf over TCP on another (for embedded-class consumers that don’t carry a gRPC client).
The frames are synthetic. Every one carries a camera_id of "SYNTHETIC" so consumers can’t mistake them for production data.
Why it exists
A real-time perception pipeline takes longer to stand up than the clients that consume it. When the pipeline isn’t ready but the integration work needs to start, this server unblocks the consumer side. It’s small — a Python package, a few hundred lines — and it ships the .proto file so the wire contract stays honest.
How to use it
pip install jbt-detection-mock
jbt-detection-mock-server --fps 20The live demo on this page shows the wire in motion: detection JSON ticking across the screen, bounding boxes drawn on a synthetic canvas. It ships in V1.1.