Skip to content

Paulescu/ml-rest-api-caching

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

How to serve ML predictions 100x faster

Table of contents

The problem

A very common way to deploy an ML model, and make its predictions accessible to other services, is by using a REST API.

It works as follows:

  1. The client requests a prediction -> Give me the price of ETH/EUR in the next 5 minutes
  2. The ML model generates the prediction,
  3. The prediction is sent back to the client -> predicted price = 2,300 USD

REST API from your textbook 🐢

This design works, but it can become terribly unefficient in many real-world scenarios.

Why?

Because more often than not, your ML model will re-compute the exact same prediction it already computed for a previous request.

So you will be doing the same (costly) work more than once.

This become a serious bottleneck if the request volume grows, and you model is large, like a Large Language Model.

So the question is:

Is there a way to avoid re-computing costly predictions? 🤔

And the answer is … YES!

Solution

Caching is a standard technique to speed up API response time.

The idea is very simple. You add a fast key-value pair database to your system, for example Redis, and use it to store past predictions.

When the first request hits the API, your cache is still empty, so you

  • generate a new prediction with your ML model
  • store it in the cache, as a key-value pair, and
  • return it to the client

REST API with a fast in-memory cache ⚡

Now, when the second request arrives, you can simply

  • load it from the cache (which is super fast), and
  • return it to the client

REST API with a fast in-memory cache ⚡


To ensure the predictions stored in your cache are still relevant, you can set an expiry date. Whenever a prediction in the cache gets too old, it is replaced by a newly generate prediction.

For example

If your underlying ML model is generating price predictions 5 minutes into the future, you can tolerate predictions that are up to, for example, 1-2 minutes old.

Run the whole thing in 5 minutes

  1. Install all project dependencies inside an isolated virtual env, using Python Poetry

    $ make install
    
  2. Run the REST API without cache

    $ make api-without-cache
    
  3. Open another terminal and run

    $ make requests
    

    to send 100 requests and check the response time

    Time taken: 1014.67ms
    Time taken: 1027.10ms
    Time taken: 1013.05ms
    Time taken: 1011.15ms
    Time taken: 1004.31ms
    Time taken: 1017.23ms
    Time taken: 1011.73ms
    Time taken: 1009.76ms
    Time taken: 1011.26ms
    ...
    
  4. Stop the api and re-start it, this time enabling the cache

    $ make api-with-cache
    

    and resend the 100 requests from another terminal

    $ make requests
    

    The response time for the first request is still high, but 100x faster for most of the the following requests.

    Time taken: 1029.59ms <-- new prediction
    Time taken: 13.09ms <-- very fast
    Time taken: 8.47ms <-- very fast
    Time taken: 7.74ms <-- very fast
    Time taken: 12.98ms <-- very fast
    Time taken: 1020.92ms <-- new prediction
    Time taken: 8.40ms <-- very fast
    Time taken: 12.61ms <-- very fast
    Time taken: 10.55ms <-- very fast
    

    In the code I am setting the cache expiry to 5 seconds.

    # src/api.py
    cache = PredictorCache(seconds_to_invalidate_prediction=5)
    

    This is a parameter that you can tune based on how fast your ML model predictions become obsolete.

Wanna learn more real-world ML?

Join more than 18k builders to the Real-World ML Newsletter.

Every Saturday morning.

For FREE