Skip to content

Serve the embeddings of a PyLate model using FastAPI

The server.py script (located in the server folder) allows to create a FastAPI server to serve the embeddings of a PyLate model. To use it, you need to install the api dependencies: pip install "pylate[api]" Then, run python server.py to launch the server.

You can then send requests to the API like so:

curl -X POST http://localhost:8002/v1/embeddings \
  -H "Content-Type: application/json" \
  -d '{
    "input": ["Query 1", "Query 2"],
    "model": "lightonai/colbertv2.0",
    "is_query": false
  }'
If you want to encode queries, simply set ìs_query to True.

Tip

Note that the server leverages batched, so you can do batch processing by sending multiple separate calls and it will create batches dynamically to fill up the GPU.

For now, the server only support one loaded model, which you can define by using the --model argument when launching the server.