AutoGineer
Generated banner for Upstash Vector JS
Generated logo for Upstash Vector JS

Upstash Vector JS

UpstashOfficialCreated by Upstash

  • Skill
  • Tool integration
  • Data and AI
  • MIT
  • No issues found
Download ZIP

From the author

Work with the @upstash/vector TypeScript/JavaScript SDK, a serverless vector database for embeddings, similarity search, semantic search, and RAG (retrieval-augmented generation). Use when upserting, querying, fetching, ranging, or deleting vectors, upserting raw text against an index with a built-in embedding model, choosing dense, sparse, or hybrid indexes, filtering by metadata, organizing data with namespaces, running resumable queries, or connecting Upstash Vector to an AI or LLM application. Also use when the user asks for a vector store, vector search, nearest-neighbor or kNN search, embeddings storage, semantic cache, recommendations or similarity features, or a hosted vector index that needs no infrastructure.
— the description by Upstash

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides guidance for using the @upstash/vector TypeScript/JavaScript SDK. It covers the core functionality required to interact with a serverless vector database, including upserting vectors, performing similarity searches, managing namespaces, and utilizing metadata filtering. The skill serves as a reference for developers building AI and RAG applications who need to store and retrieve embeddings without managing infrastructure.

What it does

  • Provides methods for upserting, querying, fetching, and deleting vectors.
  • Explains how to organize data using namespaces.
  • Details the implementation of dense, sparse, and hybrid index structures.
  • Guides users on applying metadata filters during vector queries.
  • Supports the integration of vector storage into LLM and AI applications.
  • Offers instructions for running resumable queries and managing index information.

When to use it

  • When building RAG applications that require a vector database.
  • When implementing semantic search or recommendation features.
  • When you need to store and query vector embeddings in a serverless environment.
  • When you need to filter vector search results based on associated metadata.
  • When working with hybrid or sparse indexing strategies.

Advantages

  • Simplifies interaction with serverless vector storage via a dedicated SDK.
  • Provides clear patterns for managing vector data and namespaces.
  • Enables advanced search capabilities like hybrid indexing and metadata filtering.
  • Facilitates easy integration with AI and LLM workflows.

Usage examples

“How do I initialize the Upstash Vector client in TypeScript?”
The agent provides the code to import the Index class and initialize it using the required REST URL and token from environment variables.
“Show me how to perform a similarity search with metadata filtering.”
The agent demonstrates the index.query method, showing how to include the vector data and a filter object to narrow results by metadata.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/upstash/upstash-vector-js/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip upstash-vector-js.zip -d .agents/skills

Documentation by Upstash

Vector Documentation Skill

Bundled docs and source

Before writing or debugging SDK code, check node_modules/@upstash/vector/docs/ for bundled docs and node_modules/@upstash/vector/src/ for readable TypeScript source. Read and search the relevant files when present; otherwise use the references in this skill.

Quick Start

Vector is a high‑performance vector database for storing, querying, and managing vector embeddings.

Basic workflow:

  • Install the Vector TS SDK.

  • Connect to a Vector instance.

  • Upsert vectors, query them, and manage namespaces.

Example (TypeScript):

import { Index } from "@upstash/vector";
const index = new Index({
  url: process.env.UPSTASH_VECTOR_REST_URL!,
  token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
});

await index.upsert([{ id: "1", vector: [0.1, 0.2], metadata: { tag: "example" } }]);

const results = await index.query({
  vector: [0.1, 0.2],
  topK: 5,
});

For full usage, refer to the linked skill files below.

Other Skill Files

TS SDK Reference

  • sdk-methods: Explains SDK commands: delete, fetch, info, query, range, reset, resumable-query, upsert

Features

  • features/namespaces: Explains namespaces and dataset organization.

  • features/index-structure: Covers hybrid and sparse index structures.

  • features/filtering-and-metadata: Details metadata storage and server-side filtering.

Use these files for deeper guidance on SDK usage, advanced configurations, algorithms, and integrations.

Files

features/namespaces.md

Vector Feature: Namespaces

Namespaces partition a single Upstash Vector index into fully isolated subsets. Each request executes only within its specified namespace.

Key Concepts

  • Every index has a default namespace named "" (empty string).

  • Additional namespaces are created automatically on first upsert.

  • If no namespace is provided, all operations use the default.

Using Namespaces

Upsert and query operations scoped to a namespace automatically create it if missing.

import { Index } from "@upstash/vector";
const index = new Index({ url: "URL", token: "TOKEN" });
const ns = index.namespace("ns");
await ns.upsert({ id: "id-0", vector: [0.1, 0.2] });
await ns.query({ vector: [0.1, 0.2], topK: 5 });

Operations

await index.deleteNamespace("ns");
await index.listNamespaces();

Common Pitfalls

  • Forgetting to specify namespace causes writes to go into the default namespace.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Upstash
Publisher
Upstash (Official)
Source
upstash/skills · skills/upstash-vector-js · commit 9f9e3e5
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Upstash.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download upstash-vector-js.zip