Skip to content

DOC-7161: Add a RedisVL queries interactive demo - #4226

Open
paoloredis wants to merge 3 commits into
mainfrom
DOC-7161
Open

paoloredis wants to merge 3 commits into
mainfrom
DOC-7161

Conversation

@paoloredis

@paoloredis paoloredis commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

Three tabs, one query type each, on the food delivery sample data's restaurants (JSON under restaurant:{id}, plus a description to search):

  • Vector query: pick a phrase and how many results to return, with optional Tag and Num filters.
  • Filter query: the same filters with no vector, sorted by rating.
  • Range query: every restaurant within a distance threshold.

Each query shows its RedisVL code, the FT.SEARCH command RedisVL sends, and the schema with the fields it uses highlighted. Selecting a result, or a key in the Data tab, shows the document stored in Redis.

The distances are what Redis returned for all-mpnet-base-v2 embeddings, and the code and commands are what RedisVL 0.27.1 builds (0.27.2 builds the same). The page sits at the top of the RedisVL section, which the docs sync leaves alone and doesn't copy into version snapshots.


Note

Low Risk
Documentation and static front-end assets only; no runtime services, auth, or data pipelines are changed.

Overview
Adds a browser-only RedisVL queries interactive demo to the RedisVL docs via a new interactive-demo.md page and a {{< redisvl-demo >}} Hugo shortcode.

The widget reuses Context Retriever demo styling (context-retriever-demo.css) and adds redisvl-demo.css plus ~400 lines of vanilla JS. Users step through three tabs—vector (VectorQuery + optional Tag/Num filters), filter (FilterQuery, rating sort), and range (VectorRangeQuery with a distance slider)—on shared food-delivery restaurant sample data. For each choice it shows live-updating RedisVL Python, the FT.SEARCH command RedisVL 0.27.1 would emit, results with hit/filter/miss explanations, and subtabs for schema (highlighted fields) and stored JSON documents. Distances and ordering are pre-recorded from Redis (all-mpnet-base-v2); nothing calls Redis or an embedder at runtime. The shortcode cache-busts static assets with MD5 query params and guards against double-initialization if included twice.

Reviewed by Cursor Bugbot for commit bd617ca. Bugbot is set up for automated code reviews on this repo. Configure here.

Three tabs, one query type each, on the food delivery sample data's
restaurants (JSON under restaurant:{id}, plus a description to search):

- Vector query: pick a phrase and how many results to return, with
  optional Tag and Num filters.
- Filter query: the same filters with no vector, sorted by rating.
- Range query: every restaurant within a distance threshold.

Each query shows its RedisVL code, the FT.SEARCH command RedisVL sends,
and the schema with the fields it uses highlighted. Selecting a result,
or a key in the Data tab, shows the document stored in Redis.

The distances are what Redis returned for all-mpnet-base-v2 embeddings,
and the code and commands are what RedisVL 0.27.1 builds (0.27.2 builds
the same). The page sits at the top of the RedisVL section, which the
docs sync leaves alone and doesn't copy into version snapshots.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

DOC-7161

@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 8 related items from repository history:

Memory updated at bd617ca

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale Bugbot comment from a previous run.

Comment thread static/js/redisvl-demo.js Outdated
Each input event re-rendered the whole tab, replacing the slider under
the pointer, so a drag moved one step and stopped. The slider now stays
in place, and only its label, the results, and the code are redrawn.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit b8d581e. Configure here.

Comment thread static/js/redisvl-demo.js Outdated
A Seattle restaurant filtered by city read "filtered out: city austin",
as if it were in Austin. It now reads "not in Austin", which describes
the failing condition like the numeric filters do.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@andy-stark-redis andy-stark-redis left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks really good! Approved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants