Qdrant DB Workbench

The AI-Native Vector Database Workbench — one npx away

Manage collections · Inspect points · Run vector search · Debug REST payloads — straight from your terminal.

Overview

Qdrant DB Workbench is a zero-config GUI workbench for Qdrant — the high-performance vector database. Connect to local Docker, Qdrant Cloud, or any Qdrant-compatible REST endpoint and inspect collections, points, vectors, payloads, and search responses from your browser.

It is built for developers testing embeddings, RAG pipelines, semantic search, and production vector search APIs.

npx qdrant-db-workbench

Features

| | Capability | Description | |---|---|---| | 🔌 | Universal Connect | Connect to local Qdrant, Qdrant Cloud, or a custom REST endpoint | | 🗂️ | Collection Explorer | Browse collections with vector config, distance metric, and point counts | | � | Point Inspector | Retrieve and inspect point IDs, payloads, and vectors | | � | Similarity Search | Run vector search with top K, filters, payload, and vector options | | 🧰 | Raw REST Console | Send custom requests to any Qdrant REST path | | �️ | API Key Ready | Use optional API keys for secured cloud or private deployments | | ⚡ | No Config Files | Enter the endpoint and connect directly from the workbench |

Quick Start

Step 1 — Start Qdrant locally (skip if already running or using Cloud)

docker run --rm -p 6333:6333 -p 6334:6334 qdrant/qdrant:latest

Check the service:

curl http://localhost:6333/

Step 2 — Launch the Workbench

npx qdrant-db-workbench

Your browser opens automatically at a local URL, pre-connected to http://localhost:6333. Your collections, points, and query interface load instantly. ✅

Step 3 — Connect

| Mode | What to enter | |---|---| | Local | http://localhost:6333 | | Cloud | Qdrant Cloud URL plus API key |

Usage

npx qdrant-db-workbench [options]

Options:
  -u, --url <url>           Default Qdrant endpoint shown in the UI
                             (default: http://localhost:6333)
      --api-key <token>     Prefill API key for authenticated connections
  -p, --port <port>         Port to serve the UI on (default: first free from 7070)
      --host <host>         Host to bind to (default: 127.0.0.1)
      --no-open             Do not open the browser automatically
  -h, --help                Show this help
  -v, --version             Show version

Examples

| Goal | Command | |---|---| | 🚀 Default launch | npx qdrant-db-workbench | | 💻 Local endpoint | npx qdrant-db-workbench --url http://localhost:6333 | | ☁️ Cloud cluster | npx qdrant-db-workbench --url https://my-cluster.qdrant.io --api-key my-secret-key --port 9000 | | 🖥️ Headless / remote | npx qdrant-db-workbench --host 0.0.0.0 --no-open |

Connection Modes

Local

Use a local Qdrant REST endpoint:

http://localhost:6333

Works with Docker, local binaries, or a private proxy.

Cloud

Use your Qdrant Cloud cluster URL and API key:

https://<cluster-id>.<region>.cloud.qdrant.io

Credentials are entered in the workbench UI and should not be written into source files.

Workbench Tabs

| Tab | Use it for | |---|---| | Overview | Service status, selected collection, and high-level metrics | | Collections | Browse collections, vector configuration, and collection details | | Points | Fetch and inspect points, payloads, and vectors | | Query | Run vector similarity searches with filter payloads | | Raw | Send direct REST requests to advanced Qdrant endpoints |

🧩 Also Available as a VS Code Extension

Prefer working inside your editor? Get the same workbench as a full sidebar panel in VS Code.

Install from Marketplace: https://marketplace.visualstudio.com/items?itemName=HarishKaparwan.qdrant-db

Full sidebar workbench natively inside your editor. Browse collections, run queries, inspect records, and send raw HTTP commands — zero setup required.

Also on Open VSX: https://open-vsx.org/extension/harishkaparwan/qdrant-db

Works with VS Code-compatible editors:

• VS Code (Desktop & Web)
• Cursor
• Windsurf
• VSCodium
• Gitpod
• GitHub Codespaces
• Eclipse Theia

How It Works

This package ships a pre-built static UI and a tiny zero-dependency Node web server. When you run it, the server serves the workbench locally and opens it in your browser. Passing --url injects that endpoint as the default before the page loads.

Privacy: Nothing is sent anywhere except the requests your browser makes directly to your Qdrant endpoint.

CORS: Your Qdrant instance must allow browser requests from the UI origin (http://localhost:<port>). Local Qdrant setups typically allow this by default.

Requirements

• Node.js >=20
• A running Qdrant instance (local or cloud)
• No additional dependencies or configuration files needed

Support & Feedback

| | | |---|---| | Website | Visit the public product page | | Privacy Policy | View policy |

Visit Website · Privacy Policy