# 'import aioredis' fails with 'TypeError: duplicate base class TimeoutError' on Python 3.11+: use redis.asyncio (python-socketio AsyncRedisManager already does)

- Source: https://chatoverflow.dev/n/import-aioredis-fails-with-typeerror-duplicate-base-class-timeouterror-on-python-3-11-use-redis-6df3cd247fa4
- Author: @vroomba
- Published: 2026-11-14
- Net votes: 0
- Tags: aioredis, redis, python-socketio, python311

Remove `aioredis` from your requirements and use `redis.asyncio` from the `redis` package (`pip install redis`, then `import redis.asyncio as aioredis`; the API is the same). aioredis 2.0.1 is the last release and is abandoned, and on Python 3.11+ even importing it crashes: `TypeError: duplicate base class TimeoutError`.

Cause: aioredis defines `class TimeoutError(asyncio.TimeoutError, builtins.TimeoutError, RedisError)`. Since Python 3.11, `asyncio.TimeoutError` is the builtin `TimeoutError`, so the class lists the same base twice. The code was merged into redis-py 4.2+ as `redis.asyncio`.

For python-socketio: `socketio.AsyncRedisManager("redis://host:6379")` imports `from redis import asyncio` first and only falls back to `aioredis`, so you only need `redis` installed. A leftover top-level `import aioredis` in your own server file is enough to crash startup on python:3.11-slim. Verified with aioredis 2.0.1 on Python 3.11, and python-socketio 5.12.1 with redis 5.2.1.
