py-instant-search-redis

Source code example for how to build an instant search (or real-time search) function with Redis in python.

This short source code will helps you understand about Redis Search feature and how to implement it into your
project ideas (eg: use real-time search function for any ecommerce website like Book/Movie/Product/etc..) helps
the user can search a product by tite/name/price/origin/category/… very quickly.
Especially, this function can combine multiple search condition together which helps the system return the result with high accuracy.

Technical stack:

Programming language: Python
Backend server: Flask
Redis (use redis cli and Redis server + Redisearch lib):
Data source: you can access data source from MongoDB, MySQL, Postgres, etc and then index it into redis memory (I don’t demo it here with this version)

Deploy/Running environment

OS: Linux (Ubuntu or CentOS or other)
If you want to use/try it on Windows, you can use Docker (with a linux image)

Prerequisite

Install python environment
Install Flask (https://flask.palletsprojects.com/en/2.0.x/installation/)
Install Docker Engine on your development host if you want to run code or redis server by Docker container

Withow Docker engine desktop (on MacOS):

# Install hyperkit and minikube
brew install hyperkit
brew install minikube

# Install Docker CLI
brew install docker
brew install docker-compose

# Start minikube
minikube start

# Tell Docker CLI to talk to minikube's VM
eval $(minikube docker-env)

# Save IP to a hostname
echo "`minikube ip` docker.local" | sudo tee -a /etc/hosts > /dev/null

# Test
docker run hello-world

With Docker Engine Desktop app (on MacOS):
Read this article (https://docs.docker.com/desktop/mac/install/)

Install Redis client and Redis server:

Redis Server (includes RedisSearch library)

You can run Redis server in a Docker container instead of run in on your host (this method help you install Redis quickly)
Redis server docker here (includes redis search library): docker run -p 6379:6379 redislabs/redisearch:latest

Redis client for Python: (https://oss.redis.com/redisearch/1.4/python_client.html)
or just used this command with pip: $ pip install redisearch

Example code after installed Redis Client library

More about redisearch API here
More about redis command/synctax here

from redisearch import Client, TextField, NumericField, Query

# Creating a client with a given index name
client = Client('myIndex')  #you can set any index name you want

# Creating the index definition and schema
client.create_index([TextField('title', weight=5.0), TextField('body')])

# Indexing a document
client.add_document('doc1', title = 'RediSearch', body = 'Redisearch implements a search engine on top of redis')

# Simple search
res = client.search("search engine")

# the result has the total number of results, and a list of documents
print res.total # "1"
print res.docs[0].title

# Searching with snippets
res = client.search("search engine", snippet_sizes = {'body': 50})

# Searching with complex parameters:
q = Query("search engine").verbatim().no_content().paging(0,5)
res = client.search(q)

My development environment:

Laptop/PC: MacOS BigSur
Python version: python3.8
Install Redis Cli for Mac

Redis cli helps we can connect and interact with Redis server from command-line

We can use FT._LIST to list all existing indexs on the Redis server (or create, delete, view an index information)
Check more about redis search command here (https://oss.redis.com/redisearch/Commands/)

Install steps on MacOS’s terminal

brew update
brew install redis

//To check
redis-cli ping
//if you are getting PONG Then you are good to go

Now is time to start to code

Getting started >>

Now is time to start the server

#Server running functions =================================================================>
if __name__ == "__main__":
    app.run(host='0.0.0.0', port=5000, debug=True, threaded=True)