upstash-redis

What it is and what it does

upstash-redis is a Python client library that communicates with Redis through HTTP requests to the Upstash REST API rather than establishing direct TCP connections. It's purpose-built for serverless platforms where persistent TCP connections are impractical or unavailable, such as AWS Lambda, Vercel, and Google Cloud Functions. The library provides both synchronous and asynchronous interfaces, supporting standard Redis commands including streams, pipelines, transactions, and custom commands.

The package depends only on httpx for HTTP communication and requires Python 3.8 or later. It handles connection credentials via environment variables or explicit parameters, includes automatic retry logic with configurable intervals, and supports optional base64 encoding for data serialization. The library is in GA stage and receives regular maintenance and bug fixes from Upstash's professional support team.

Use it for:

• Cache layer in AWS Lambda functions where TCP connections are ephemeral or cost-prohibitive.
• Session storage in Vercel serverless functions using Redis Streams for real-time data handling.
• Distributed task queues in Google Cloud Functions leveraging Redis pipelines and transactions.
• Rate limiting and counters in serverless APIs without managing persistent connection pools.
• Real-time event processing with Redis Streams consumer groups in containerized serverless environments.

Worth the install?

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

HTTP-based Redis client for Python that connects to Upstash Redis via REST API instead of TCP, designed for serverless environments like AWS Lambda and Google Cloud Functions.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction (one dependency), and fills a genuine gap for serverless Python applications needing Redis. The MIT license imposes no restrictions. Install it if you're building on serverless platforms and need Redis caching or data structures; skip it if you have persistent TCP connectivity and prefer the lower latency of direct Redis connections.

Install

upstash-redis on PyPI

pip install upstash-redis

uv add upstash-redis

poetry add upstash-redis

Installing upstash-redis

Before you install

Low friction: single runtime dependency (httpx), pure Python wheel, actively maintained with recent commits and regular updates under Upstash Professional Support.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install upstash-redis

from upstash_redis import Redis

redis = Redis.from_env()
redis.set("key", "value")
print(redis.get("key"))

Requires UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN environment variables or explicit url/token parameters; an active Upstash Redis database is required.

Verify before relying

• Performance characteristics compared to TCP-based Redis clients in non-serverless environments.
• Whether the retry mechanism (default: one retry after 3 seconds) is configurable for specific use cases.
• Telemetry data collection scope and whether it impacts privacy-sensitive deployments.

Package facts

Evidence: upstash_redis-1.7.0-py3-none-any.whl

Keywords: Upstash Redis, Serverless Redis

Tags

More Libraries packages