---
id: redis-simple-mq
version: "2.0.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# redis-simple-mq — Simple message queue based on Redis.

License: permissive · Maintenance: active · Downloads: 238.3K/mo

## What it is and what it does

redis-simple-mq is a thin wrapper around Redis that implements a FIFO message queue with a straightforward class-based API. It stores all messages as UTF-8 strings and provides basic enqueue and dequeue operations, plus bulk methods for moving multiple messages at once. The package requires only the redis client library as a dependency and runs on Python 3.10 and later.

It is designed for simple use cases where you need a lightweight queue without the overhead of a full message broker. The implementation is fully tested and supports unlimited parallel queues on the same Redis instance. It is most useful in applications that already use Redis and need a quick, low-ceremony way to add task or message queuing.

Use it for:

- Decouple work in a web application by enqueueing background tasks to be processed by separate workers.
- Implement a simple job queue for batch processing or scheduled tasks in a microservice.
- Buffer incoming requests or events in a high-throughput system before downstream processing.
- Coordinate message passing between multiple processes or services that share a Redis instance.
- Prototype or build a lightweight task distribution system without deploying a full message broker.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A lightweight message queue built on Redis that provides a class-based API for enqueueing and dequeueing messages in FIFO order, with support for bulk operations.

Yes, if you already run Redis and need a minimal, permissively licensed queue without external dependencies beyond redis. The low install friction and active maintenance make it a reasonable choice for simple use cases. However, the lack of community adoption and sparse documentation mean you should verify it handles your specific queue semantics before committing to production.

## Install

pip install redis-simple-mq
uv add redis-simple-mq
poetry add redis-simple-mq

## Installing redis-simple-mq

Before you install: Low friction to install as a pure Python wheel with only redis as a runtime dependency. Actively maintained with recent commits; however, the project has no stars and minimal adoption signals, so community support or long-term stability cannot be inferred.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart:

pip install redis-simple-mq

from redis import Redis
from redis_simple_mq import SimpleMQ

conn = Redis()
q = SimpleMQ(conn)
q.enqueue('Hello, World!')
message = q.dequeue()
print(message)

Requires a running Redis server accessible via the redis Python client.

Verify before relying:

- Whether bulk enqueue/dequeue methods are documented or what their performance characteristics are.
- What happens when dequeue is called on an empty queue (blocking vs. returning None).
- Whether the queue supports message expiration or TTL settings.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 238.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

redis message queue, simple task queue, fifo queue redis, lightweight message broker, redis job queue, enqueue dequeue, redis-based queue, message-queue, redis-backed

[View on SkillFed](https://skillfed.io/packages/redis-simple-mq) · [View on PyPI](https://pypi.org/project/redis-simple-mq/)