aioredis

What it is and what it does

aioredis is an asyncio-based Redis client for Python that lets you interact with Redis servers using async/await syntax. It provides both low-level protocol APIs and high-level command wrappers, supporting features like connection pooling, pipelining, transactions (Multi/Exec), Pub/Sub messaging, Sentinel failover, ACL authentication, and Redis Streams. The library can use either the hiredis C parser (optional, for performance) or a pure-Python parser.

The package was designed to integrate cleanly with asyncio applications, allowing non-blocking Redis operations. It has been tested against Redis 5.0 and 6.0 and supports Python 3.6 through 3.10. However, the repository is now archived and unmaintained—the last release was in December 2021 and the last commit in February 2023—making it unsuitable for new projects without careful consideration of long-term support implications.

Use it for:

• Building async web applications (FastAPI, aiohttp) that need to cache data or manage sessions in Redis.
• Implementing real-time Pub/Sub messaging systems where multiple async tasks subscribe to and publish Redis channels.
• Running async background job queues or task workers that read from Redis Streams or lists.
• Connecting to Redis Sentinel clusters for automatic failover in high-availability deployments.
• Batching multiple Redis commands via pipelining to reduce network round-trips in async workflows.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

An asyncio-based Redis client library providing both low-level and high-level APIs for connecting to and interacting with Redis servers.

No—not for new projects. While the package is stable and has low install friction, it is archived and abandoned with no maintenance since February 2023. The redis-py library now offers native async support, which is actively maintained and should be the default choice. Use aioredis only if you are maintaining legacy code already depending on it, and plan a migration path.

Install

aioredis on PyPI

pip install aioredis

uv add aioredis

poetry add aioredis

Installing aioredis

Before you install

Low install friction with only two lightweight runtime dependencies (async-timeout and typing-extensions). However, the package is archived and abandoned as of February 2023, with no maintenance since then—a significant concern for production use.

License in practice

MIT license is permissive and poses no restrictions on commercial or private use, modification, or redistribution.

Quickstart

import asyncio
import aioredis

async def main():
    redis = await aioredis.create_redis_pool('redis://localhost')
    await redis.set('key', 'value')
    val = await redis.get('key')
    redis.close()
    await redis.wait_closed()

asyncio.run(main())

Requires a running Redis server (5.0 or 6.0 tested); hiredis is optional but recommended for performance.

Verify before relying

• Whether redis-py's async variant (redis[asyncio]) is now the recommended replacement for new projects.
• Current compatibility with Redis 7.0+ server versions beyond the tested 5.0 and 6.0.
• Whether the pure-python parser remains performant compared to hiredis on modern hardware.

Package facts

Evidence: aioredis-2.0.1-py3-none-any.whl

Tags

More Software Development packages