---
id: walrus
version: "0.9.8"
license: unclear
license_treatment: unclear
maintenance: aging
---

# walrus — a set of utilities for working with redis

License: unclear · Maintenance: aging · Downloads: 125.4K/mo

## What it is and what it does

Walrus is a lightweight wrapper around redis-py that adds Pythonic abstractions for working with Redis. It subclasses the standard redis-py client, so you can use it as a drop-in replacement while gaining access to higher-level utilities. The package provides container classes that map Redis data types (Hash, List, Set, Sorted Set, HyperLogLog, BitField, BloomFilter) to Python-like objects, plus specialized tools for streams with consumer group support, caching with decorators, full-text search with boolean queries, graph storage, rate limiting, and locking.

The package also includes experimental active-record-style Models built on Hashes, supporting secondary indexes for filtering and basic full-text search. It's designed for developers who want to work with Redis more naturally in Python without learning a separate library API. The single runtime dependency is redis itself.

Use it for:

- Cache function results using decorators to avoid repeated computation or database queries.
- Implement distributed rate limiting or locking across multiple application instances.
- Build autocomplete or full-text search features on top of Redis data structures.
- Work with Redis streams and consumer groups for event processing or message queues.
- Store and query structured data using Models with secondary indexes.
- Use Bloom filters or HyperLogLog for approximate membership testing or cardinality estimation.

## Worth the install?

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

Walrus extends the redis-py client with Pythonic container classes and higher-level abstractions for Redis data types, streams, caching, full-text search, and models.

Yes, with conditions. Walrus is stable, low-friction to install, and offers genuine convenience over raw redis-py for common patterns like caching and streams. However, verify the license terms before use (metadata is unclear), and be aware that maintenance is aging—the last release was 211 days ago. The experimental Models feature may not be production-ready. For straightforward Redis operations, it's a solid choice; for mission-critical systems, confirm support expectations.

## Install

pip install walrus
uv add walrus
poetry add walrus

## Installing walrus

Before you install: Low install friction; pure Python wheel. Maintenance status is aging—last commit was 2026-01-15 and no release in 211 days—but the repository remains active and unarchived with 1205 stars.

License in practice: License treatment is unclear; no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before use in proprietary or restrictive-license contexts.

Quickstart:

pip install walrus

import walrus
db = walrus.Database()
my_hash = db.Hash('my_key')
my_hash['field'] = 'value'

Requires a running Redis server.

Verify before relying:

- Exact Python version support is unspecified; classifiers list both Python 2 and 3 but requires_python is null.
- License details are not declared in package metadata; verify licensing terms in the repository.
- Stability of experimental features (Models, secondary indexes) and their production readiness.
- Default Redis connection parameters and whether they require explicit configuration.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 125.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

redis python wrapper, redis data structures, redis streams consumer groups, redis caching decorator, redis full-text search, redis models orm, redis rate limiting, redis autocomplete, redis-client, caching, streams

[View on SkillFed](https://skillfed.io/packages/walrus) · [View on PyPI](https://pypi.org/project/walrus/)