Welcome to redis-limpyd’s documentation!

Idea is to provide an easy way to store objects in Redis, without losing the power and the control of the Redis API, in a limpid way. So, scope is to provide just as abstraction as needed.


  • Don’t care about keys, limpyd do it for you
  • Retrieve objects from some of their attributes
  • Retrieve objects collection
  • CRUD abstraction
  • Keep the power of all the Redis data types in your own code

Source code: https://github.com/yohanboniface/redis-limpyd

PyPI Version Build Status

Show me some code!

Example of configuration:

from limpyd import model

main_database = model.RedisDatabase(

class Bike(model.RedisModel):

    database = main_database

    name = model.InstanceHashField(indexable=True, unique=True)
    color = model.InstanceHashField()
    wheels = model.StringField(default=2)

So you can use it like this:

>>> mountainbike = Bike(name="mountainbike")
>>> mountainbike.wheels.get()
>>> mountainbike.wheels.incr()
>>> mountainbike.wheels.get()
>>> mountainbike.name.set("tricycle")
>>> tricycle = Bike.collection(name="tricycle")[0]
>>> tricycle.wheels.get()
>>> tricycle.hmset(color="blue")
>>> tricycle.hmget('color')
>>> tricycle.hmget('color', 'name')
['blue', 'tricycle']
>>> tricycle.color.hget()
>>> tricycle.color.hset('yellow')
>>> tricycle.hmget('color')

Indices and tables