Project Links

Meta

Author: Ali-Akber Saifee

Maintainer: Ali-Akber Saifee

Requires Python: >=3.10

Classifiers

Development Status

5 - Production/Stable

Framework

AnyIO
AsyncIO
Trio

Intended Audience

Developers
Information Technology
System Administrators

Operating System

OS Independent

Programming Language

Python
Python :: 3
Python :: 3 :: Only
Python :: 3.10
Python :: 3.11
Python :: 3.12
Python :: 3.13
Python :: 3.14
Python :: Implementation :: PyPy

Topic

Software Development :: Libraries :: Python Modules
System :: Distributed Computing

Typing

Typed

[!IMPORTANT] To learn about breaking changes and migration steps for version 6 please see Migrating from 5.x to 6.0.

If you are looking for the 5.x implementation, please refer to the 5.x branch.

coredis

Fast, async, fully-typed Redis client with support for cluster and sentinel

Features

Fully typed, even when using pipelines, Lua scripts, and libraries
Redis Cluster and Sentinel support
Built with structured concurrency on anyio, supports both asyncio and trio
Smart command routing: multiplexing when possible, pooling otherwise
Server-assisted client-side caching implementation
Redis Stack modules support
Redis PubSub
Pipelining
Lua scripts and Redis functions with support for typing
Convenient Stream Consumers implementation
Comprehensive documentation
Optional runtime type validation (via beartype)

Installation

$ pip install coredis

Getting started

Single node or cluster

import anyio
import coredis

async def main() -> None:
    client = coredis.Redis(host='127.0.0.1', port=6379, db=0, decode_responses=True)
    # or cluster
    # client = coredis.RedisCluster(startup_nodes=[coredis.connection.TCPLocation("127.0.0.1", 6379)], decode_responses=True)
    async with client:
        await client.flushdb()

        await client.set("foo", 1)
        assert await client.exists(["foo"]) == 1
        assert await client.incr("foo") == 2
        assert await client.expire("foo", 1)
        await anyio.sleep(0.1)
        assert await client.ttl("foo") == 1
        await anyio.sleep(1)
        assert not await client.exists(["foo"])

        async with client.pipeline() as pipeline:
            pipeline.incr("foo")
            value = pipeline.get("foo")
            pipeline.delete(["foo"])

        assert await value == "1"

anyio.run(main, backend="asyncio") # or trio

Sentinel

import anyio
import coredis

async def main() -> None:
    sentinel = coredis.Sentinel(sentinels=[("localhost", 26379)])
    async with sentinel:
        primary: coredis.Redis  = sentinel.primary_for("myservice")
        replica: coredis.Redis  = sentinel.replica_for("myservice")

        async with primary, replica:
            assert await primary.set("fubar", 1)
            assert int(await replica.get("fubar")) == 1

anyio.run(main, backend="asyncio") # or trio

Compatibility

To see a full list of supported Redis commands refer to the Command compatibility documentation. Details about supported Redis modules and their commands can be found here.

coredis is tested against redis versions >= 7.0 The test matrix status can be reviewed here

coredis is additionally tested against:

uvloop >= 0.15.0
trio

Supported python versions

3.10
3.11
3.12
3.13
3.14
PyPy 3.10
PyPy 3.11

Redis API compatible databases

coredis is known to work with the following databases that have redis protocol compatibility:

References

6.0.0rc3 Feb 07, 2026

6.0.0rc2 Jan 30, 2026

6.0.0rc1 Jan 18, 2026

5.0.0rc2 Jul 11, 2025

5.0.0rc1 Jul 07, 2025

4.18.0rc4 Dec 09, 2024

4.18.0rc3 Dec 09, 2024

4.17.0 Apr 19, 2024

4.16.0 Aug 31, 2023

4.16.0rc1 Aug 12, 2023

4.12.0rc1 Apr 20, 2023

4.12.0b4 Apr 11, 2023

4.12.0b3 Apr 05, 2023

4.12.0b2 Mar 27, 2023

4.12.0b1 Mar 27, 2023

3.0.0rc2 Mar 17, 2022

3.0.0rc1 Mar 17, 2022

Wheel compatibility matrix

Platform	CPython 3.10	CPython 3.11	CPython 3.12	CPython 3.13	CPython 3.14	CPython (additional flags: t) 3.14	Python 3
any
macosx_10_13_x86_64
macosx_10_9_x86_64
macosx_11_0_arm64
manylinux2014_aarch64
manylinux2014_x86_64
manylinux_2_17_aarch64
manylinux_2_17_x86_64
manylinux_2_28_aarch64
manylinux_2_28_x86_64