К основному содержанию
скилл CX Codex

qdrant-edge — скилл для Claude Code: возможности и установка

Скилл для Claude Code помогает разрабатывать приложения на Qdrant Edge. Разбирает синхронизацию локального шарда, поиск BM25 и обслуживание индексов.

Apache-2.0 328 установок ★ 271 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add qdrant/skills --skill qdrant-edge -a claude-code
Открыть на GitHub

Что делает qdrant-edge

Скилл объясняет, как устроен встроенный в приложение шард Qdrant Edge и какие операции уже доступны: BM25, применение снимков, фасетный поиск и подсчёт записей. Для синхронизации с сервером готового вызова .sync() нет: транспорт и отправку локальных изменений нужно собрать самостоятельно.

В руководстве описаны обновление шарда через снимки, частичные снимки и объединение векторов с полнотекстовым поиском. Для плотных эмбеддингов требуется отдельный пакет fastembed; сам Edge работает с Python и Rust. После массовой записи нужно вызвать optimize, иначе новые точки ищутся перебором. Edge пока в бета-версии, поэтому версию придётся фиксировать: API меняется между релизами.

Также скилл помогает использовать unpack_snapshot и update_from_snapshot, не обрабатывая сегменты вручную. Edge работает на одном узле; распределённый поиск требует другого решения.

Какие задачи решает

  • синхронизировать локальный шард с серверным снимком
  • настроить BM25-поиск по полям payload
  • объединить результаты векторного и текстового поиска
  • ускорить поиск после массовой записи вызовом optimize
  • обновить шард частичным снимком

Примеры запросов агенту

  • Объясни, как обновлять локальный Qdrant Edge из снимка сервера.
  • Покажи, как настроить BM25-поиск по полю payload в Edge.
  • Как объединить плотный векторный поиск и полнотекстовый запрос в Edge?

Как установить qdrant-edge

1Через Skills CLI (Vercel)

npx skills add qdrant/skills --skill qdrant-edge -a claude-code

2Вручную: положить файлы

~/.claude/skills/qdrant-edge/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/qdrant-edge/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о qdrant-edge

Как установить qdrant-edge в Claude Code?

Выполните npx skills add qdrant/skills --skill qdrant-edge -a claude-code. Скилл будет доступен по пути ~/.claude/skills/qdrant-edge/SKILL.md.

Что делает qdrant-edge?

Скилл объясняет разработку на Qdrant Edge: синхронизацию снимками, BM25 и гибридный поиск, а также обслуживание шарда.

Как синхронизировать Edge с сервером?

В Edge нет готового .sync(): нужно самостоятельно организовать загрузку снимка и транспорт. Для обновлений можно применять частичные снимки через snapshot_manifest, unpack_snapshot и update_from_snapshot.

Исходный текст

SKILL.md · Apache-2.0
---
name: qdrant-edge
description: "Guides building on Qdrant Edge, the embedded in-process shard. Use when someone asks 'how to sync Edge with the server', 'keep a local shard in sync with Qdrant Cloud', 'BM25 or keyword search on Edge', 'hybrid search on Edge', 'embeddings on device', 'Edge snapshots', 'apply a partial snapshot', 'why is my Edge search slow after inserts', or is writing custom sync, BM25, or fusion code against qdrant-edge. Also use when deciding what Edge ships built-in versus what you must implement."
---

# Building on Qdrant Edge

Edge is the Qdrant engine embedded in your process (Python or Rust), not a thin local vector store to wrap. The failure mode is rebuilding what the shard already ships: keyword scoring, snapshot apply, faceting, counting. Before writing any of that, check the shard API. One thing Edge does NOT give you is a one-call cloud sync, so knowing what is built in keeps you from both reinventing built-ins and expecting capabilities Edge lacks. Edge is single-node and shares the server's data format.

- Edge is in beta: pin your version, the API drifts between releases [Qdrant Edge](https://skills.qdrant.tech/md/documentation/edge/).


## Syncing a Shard with a Qdrant Server

Use when: seeding a shard from a server, keeping it fresh, backing it up, or aggregating many devices into one collection.

There is no built-in `.sync()`. Sync is a pattern you assemble from shard helpers plus your own transport, so do not go looking for one call.

- Follow the documented dual-shard pattern: a `mutable` shard for local writes plus an `immutable` shard restored from a server snapshot, query both, refresh on a schedule [Edge synchronization guide](https://skills.qdrant.tech/md/documentation/edge/edge-synchronization-guide/).
- You write the snapshot download (plain HTTP to the shard snapshot endpoint), then apply it with `unpack_snapshot` and `update_from_snapshot`. Do not untar or merge segments by hand [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/).
- Refresh incrementally with a partial snapshot built from `snapshot_manifest`, not a full snapshot every cycle [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/).
- Push is your own dual-write: on each local upsert, enqueue the point and let a background worker upsert it to the server, buffering while offline [Synchronization patterns](https://skills.qdrant.tech/md/documentation/edge/edge-data-synchronization-patterns/).


## Keyword and Hybrid Search on Device

Use when: you need exact-term or BM25 matching, alone or alongside vectors.

- BM25 is built into Edge: create a full-text index with `scoring` enabled on the payload field (with the stemmer and stopwords for your language) and rank with a `TextQuery`. It needs no embedding model and derives document lengths from your data. Do not ship a second BM25 library [Edge BM25](https://skills.qdrant.tech/md/documentation/edge/edge-bm25/)
- Need sparse BM25 vectors instead, for example to match a server collection that uses sparse vector BM25? Edge's BM25 embedder (`Bm25` in Python, `EdgeBm25` in Rust) produces server-compatible sparse vectors: `embed_document` for documents, `embed_query` for queries [Edge BM25](https://skills.qdrant.tech/md/documentation/edge/edge-bm25/)
- Dense embeddings are NOT in Edge: generate them on device with the separate `fastembed` package [FastEmbed embeddings](https://skills.qdrant.tech/md/documentation/edge/edge-fastembed-embeddings/)
- For hybrid search, run the dense and keyword legs as `prefetches` (a `TextQuery`, or a sparse vector query) and fuse them with a `Fusion` query in a single `query` call, instead of combining rankings in application code [Reading data](https://skills.qdrant.tech/md/documentation/edge/edge-api/reading-data/)


## Operating the Shard

Use when: writes have accumulated, search is slow after inserts, or a backup is larger than the data.

- Edge has NO background optimizer. Call `optimize` after bulk writes: it builds indexes and reclaims deleted points. Until then, new points are searched by brute force [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/)
- Faceting, counting, and enumeration are built in (`facet`, `count`, `scroll`); index the fields you filter or facet with `create_field_index` rather than aggregating in application code [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/)
- The write-ahead log is pre-allocated to 32 MB and inflates apparent disk and backup size. Shrink it with `wal_options` (Rust), and do not treat raw file size as real usage [Edge quickstart](https://skills.qdrant.tech/md/documentation/edge/edge-quickstart/)


## What NOT to Do

- Expect a bidirectional `.sync()` or a built-in push path: Edge gives you snapshot apply, you own the transport and the dual-write
- Untar or merge snapshot segments by hand instead of using `unpack_snapshot` and `update_from_snapshot`
- Ship a custom or third-party BM25 when Edge has one built in
- Run a `TextQuery` on a full-text index created without `scoring`: BM25 ranking needs it enabled
- Use the BM25 embedder's `embed_document` for queries or `embed_query` for documents: the weighting differs and results go wrong
- Combine dense and keyword rankings in application code: Edge `query` accepts `prefetches` and fuses them with a `Fusion` query
- Assume a background optimizer like the server's: nothing is indexed or compacted until you call `optimize`
- Reach for Edge when you need distributed or multi-node search: it is single-node [Qdrant Edge](https://skills.qdrant.tech/md/documentation/edge/)
- Claim support for a language beyond Python and Rust, or an OS or accelerator the Edge docs do not state

© qdrant · Apache-2.0 · qdrant/skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
qdrant-vector-search Orchestra Research Скилл qdrant-vector-search для Claude Code помогает проектировать поиск по векторам в Qdrant для RAG и семантического поиска, включая фильтрацию по метаданным и масштабирование. CX Codex +1 1 100установок qdrant-performance-optimization официальный github Скилл qdrant-performance-optimization для GitHub Copilot разбирает производительность Qdrant: скорость поиска, построение индекса и расход памяти. Находит узкие места в конфигурации. CX Codex +1 61установок grepai-storage-qdrant yoanbernabeu Скилл grepai-storage-qdrant настраивает векторную базу данных Qdrant в роли хранилища для поискового движка GrepAI. Инструкция подключает локальный Docker-контейнер или кластер Qdrant Cloud через gRPC на порту 6334. CX Codex +1 570установок postgres-hybrid-text-search tigerdata Скилл postgres-hybrid-text-search учит ассистента настраивать гибридный поиск в PostgreSQL через связку pg_textsearch для BM25 и pgvector с объединением по алгоритму RRF. CX Codex +1 411установок qdrant giuseppe-trisciuoglio Скилл даёт шаблоны интеграции векторной базы Qdrant в Java и Spring Boot через LangChain4j. Помогает настроить семантический поиск и хранилище эмбеддингов для RAG. CX Codex +1 3 900установок rag-infrastructure devops-skills Скилл rag-infrastructure для сборки RAG-конвейера: загрузка документов, эмбеддинги, векторное хранилище, гибридный поиск и ответы LLM по найденному контексту. CX Codex +1 360установок

Из того же набора12

Весь набор →
qdrant-monitoring Скилл qdrant-monitoring для Claude Code помогает настроить мониторинг Qdrant и разбирать сбои по метрикам. Он направляет к инструкциям по настройке или диагностике. CX Codex +1 1 600установок qdrant-version-upgrade Скилл qdrant-version-upgrade для Claude Code помогает спланировать обновление Qdrant и SDK с учётом совместимости версий. Он разбирает переходы между версиями, порядок действий и изменения после обновления. CX Codex +1 1 400установок qdrant-performance-optimization Скилл qdrant-performance-optimization для Claude Code сопоставляет симптомы при настройке Qdrant с под-скиллами по скорости поиска, индексации и памяти. CX Codex +1 1 700установок qdrant-advisor Скилл qdrant-advisor подтягивает официальные инструкции из skills.qdrant.tech для решения сбоев кластера, утечек памяти и замедления индексов Qdrant. CX Codex +1 782установок qdrant-multitenancy Скилл qdrant-multitenancy для Claude Code, Codex и Cursor. Направляет выбор архитектуры изоляции данных нескольких клиентов в векторной базе Qdrant. CX Codex +1 298установок qdrant-sizing Скилл qdrant-sizing рассчитывает оперативную память, диск, процессоры и число узлов кластера Qdrant под заданный объём векторов и требования к задержкам. CX Codex +1 222установок qdrant-migration-tool Скилл qdrant-migration-tool для Claude Code переносит векторные данные и метаданные в Qdrant из других баз данных. Инструмент управляет процессом миграции, включая возобновление прерванных операций. CX Codex +1 137установок qdrant-hybrid-cloud-setup Скилл qdrant-hybrid-cloud-setup для Claude Code помогает развернуть Qdrant Hybrid Cloud в собственном Kubernetes-кластере. Подключается при настройке агента и оператора, хранилища, резервных копий или доступа к кластеру. CX Codex +1 121установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой