Skip to main content

Query and response

This page documents what goes on when a command such as "AddImage", or "FindImage" is sent to the database.

What the exchange between client and server looks like.

Query and Response

At the most fundamental level, a query is a formatted message that is sent to a server on a connection.

The query message comprises of 2 sections:


A command could be any one of these.


A blob is the byte buffer obtained by reading any file in raw mode or the item from the list of blobs in a response.

with open("image.jpg", "rb") as ins:
blob =


The list of results has a 1:1 cardinality with commands.

A result may have a list of entities.

Here are some more Examples and more description