upstash-redis-js

Upstash Redis SDK - Complete Skills Guide

This directory contains comprehensive guides for using the @upstash/redis SDK. These skill files are designed to help developers and AI assistants understand and use the SDK effectively.

Installation

npm install @upstash/redis

Quick Start

Basic Initialization

import { Redis } from "@upstash/redis";

// Initialize with explicit credentials
const redis = new Redis({
  url: "UPSTASH_REDIS_REST_URL",
  token: "UPSTASH_REDIS_REST_TOKEN",
});

// Or initialize from environment variables
const redis = Redis.fromEnv();

Environment Variables

Set these in your .env file:

UPSTASH_REDIS_REST_URL=https://your-redis.upstash.io
UPSTASH_REDIS_REST_TOKEN=your-token-here

No credentials yet? If you're an agent that needs scratch Redis and the user hasn't provided a database, you can mint a temporary one with a single POST to https://upstash.com/start-redis (3-day TTL, no signup).

Skill Files Overview

Data Structures (data-structures/)

Redis data types with auto-serialization examples:

• strings.md - GET, SET, INCR, DECR, APPEND with automatic type handling
• hashes.md - HSET, HGET, HMGET with object serialization
• lists.md - LPUSH, RPUSH, LRANGE with array handling
• sets.md - SADD, SMEMBERS, set operations
• sorted-sets.md - ZADD, ZRANGE, ZRANK, leaderboard patterns
• json.md - JSON.SET, JSON.GET, JSONPath queries for nested objects
• streams.md - XADD, XREAD, XGROUP, consumer groups
• arrays.md - ARSET, ARINSERT, ARSCAN, ARGREP, AROP, ring buffers with ARRING on sparse index-addressed arrays
• vector-indexes.md - VECTOR.CREATE, VECTOR.ADD, VECTOR.QUERY nearest-neighbour search inside Redis via redis.vector

Advanced Features (advanced-features/)

Complex operations and optimizations:

• auto-pipeline.md - Automatic request batching, performance optimization
• pipeline-and-transactions.md - Manual pipelines, MULTI/EXEC for atomic operations
• scripting.md - Lua scripts, EVAL, EVALSHA for server-side logic