---
id: redislite
version: "6.2.912183"
license: BSD License
license_treatment: permissive
maintenance: dormant
---

# redislite — Redis built into a python package

License: permissive · Maintenance: dormant · Downloads: 94.6K/mo

## What it is and what it does

Redislite wraps Redis into a Python package that automatically installs, configures, and manages a Redis server instance on first use. Instead of running Redis as a separate service, you import Redislite and create a Redis object pointing to a local database file; the server starts automatically and shuts down cleanly when your Python process exits. It provides drop-in replacements for redis-py's Redis and StrictRedis classes, so existing code using those libraries can often switch to Redislite with minimal changes.

The package supports all standard Redis operations—keys, sets, hashes, lists, sorted sets—plus advanced features like replication and clustering. You can run a single shared server, multiple independent servers in the same script, or configure different instances with custom settings. Data persists across runs when you reuse the same database file. Security defaults to user-only access on the local system.

Use it for:

- Development and testing: use Redis features locally without Docker or a running service.
- Embedded caching: add a persistent key-value cache to a standalone Python application.
- Prototyping: quickly test Redis-based code before deploying to a production Redis cluster.
- Multi-server simulation: spin up multiple independent Redis instances in a single script for testing replication or failover logic.
- Migrating from redis-py: patch existing code that uses redis-py to run against Redislite with minimal refactoring.

## Worth the install?

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

Redislite embeds a self-contained Redis server into a Python package, providing Redis key-value store functionality without requiring a separate server installation or management.

Yes, if you need local Redis functionality for development, testing, or embedding in a standalone application and can tolerate dormant maintenance. The package is stable (Production/Stable classifier), has no known vulnerabilities, and works on modern Python versions. Not recommended for production services requiring active security updates or recent Redis features; use a standalone Redis server instead.

## Install

pip install redislite
uv add redislite
poetry add redislite

## Installing redislite

Before you install: Medium install friction due to compiled wheels for multiple Python versions (3.8–3.12, including PyPy variants). Last release was 2023-12-01, over 987 days ago; the repository is not archived but marked dormant. Requires Python development headers on Linux systems.

License in practice: BSD License (permissive) places no significant restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install redislite

from redislite import Redis
redis_connection = Redis('/tmp/redis.db')
redis_connection.set('key', 'value')
print(redis_connection.get('key'))

On Linux, Python development headers must be installed before installation (e.g., python-dev on Ubuntu/Debian, python-devel on Redhat/Fedora).

Verify before relying:

- Current stability and bug-fix cadence given 987 days since last release and dormant maintenance status.
- Whether the embedded Redis version (6.2) meets security or feature requirements for your use case.
- Performance characteristics compared to connecting to a standalone Redis server for production workloads.

## Package facts

- License: BSD License (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: dormant
- Downloads: 94.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

embedded redis python, redis without server setup, in-process key-value store, redis bindings python, local redis database, redis persistence python, standalone redis package, embedded-database, redis-alternative, development-tool

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