Qdrant clients SDK
Use the official Qdrant clients and API references to answer SDK questions, choose an integration path, and fetch curated snippets for concrete operations such as collection creation, vector search, payload filtering, and point upload.
When to invoke
- "Which Qdrant client should I install for this language?"
- "Show the Qdrant API reference for uploading points."
- "Find a Qdrant snippet for TypeScript vector search."
- "Should I use Qdrant REST or gRPC?"
- "Install the Qdrant Python client with FastEmbed."
Official clients and installs
| Language |
Official SDK |
Install command or source |
| Python |
qdrant-client |
pip install qdrant-client[fastembed] from https://github.com/qdrant/qdrant-client |
| JavaScript / TypeScript |
qdrant-js |
npm install @qdrant/js-client-rest from https://github.com/qdrant/qdrant-js |
| Rust |
rust-client |
cargo add qdrant-client from https://github.com/qdrant/rust-client |
| Go |
go-client |
go get github.com/qdrant/go-client from https://github.com/qdrant/go-client |
| .NET |
qdrant-dotnet |
dotnet add package Qdrant.Client from https://github.com/qdrant/qdrant-dotnet |
| Java |
java-client |
Maven Central artifact io.qdrant/client at https://central.sonatype.com/artifact/io.qdrant/client and source https://github.com/qdrant/java-client |
API surfaces
| Surface |
Use when |
Reference |
| REST API |
You are new to Qdrant, prototyping, debugging with HTTP, or need OpenAPI-generated clients. |
OpenAPI Reference https://api.qdrant.tech/api-reference; OpenAPI JSON https://github.com/qdrant/qdrant/blob/master/docs/redoc/master/openapi.json |
| gRPC API |
You need lower overhead, streaming-friendly integrations, or native generated protobuf clients. |
gRPC protobuf definitions https://github.com/qdrant/qdrant/tree/master/lib/api/src/grpc/proto |
| Curated snippets |
You need operation-level examples before writing code. |
https://snippets.qdrant.tech/search?language=python&query=how+to+upload+points |
Snippet search workflow
- Choose one supported snippet language:
python, typescript, rust, java, go, or csharp.
- Convert the user's intent into a concise query such as
how to upload points, hybrid search, or filter by payload.
- Fetch snippets with
curl -X GET "https://snippets.qdrant.tech/search?language=<language>&query=<url-encoded-query>".
- Add
&format=json only when structured snippet output is required; otherwise keep the default markdown response.
- Preserve version notes such as
vlatest, source URLs, idempotency comments, and retry flags from the snippet.
Point upload reference pattern
When a snippet teaches point upload, preserve these API names and behaviors in generated code or advice:
| Concept |
API or value |
Rule |
| Python client method |
client.upload_points(...) from qdrant_client |
Use for uploading multiple vector-embedded points to a collection. |
| Point type |
models.PointStruct |
Include id, payload, and vector. |
| Collection argument |
collection_name="{collection_name}" |
Replace {collection_name} with the real collection. |
| Example payload |
payload={"color": "red"} and payload={"color": "green"} |
Payloads are metadata for filtering. |
| Example vectors |
vector=[0.9, 0.1, 0.1] and vector=[0.1, 0.9, 0.1] |
Use dimensionality that matches the collection schema. |
| Reliability flags |
parallel=4, max_retries=3 |
Mention when preserving robust indexing behavior. |
| Idempotency |
Re-uploading and re-uploading the same id overwrites existing points. |
If ids are omitted, Qdrant auto-generates UUIDs. |
| Documentation source |
https://qdrant.tech/documentation/manage-data/points/ |
Cite when discussing point management. |
Output template
## Qdrant SDK answer
**Status:** ready | needs lookup | blocked
**Language:** `python` | `typescript` | `rust` | `java` | `go` | `csharp` | `rest` | `grpc`
**Recommended surface:** <SDK, REST API, or gRPC API>
| Need | Command, API, or reference | Notes |
| --- | --- | --- |
| Install | `<install command>` | <package/source> |
| Example | `<method or endpoint>` | <snippet source or caveat> |
| Validation | `<command or check>` | <expected result> |
Quality gate
References
1---2name: qdrant-clients-sdk3description: Select and use official Qdrant client SDKs, REST API, gRPC API, and curated snippet search. Use this skill when the user asks for Qdrant API reference, client installation commands, SDK language choice, upload point examples, FastEmbed setup, or REST versus gRPC guidance.4---56<!-- Generated from harness/github-copilot/skills/qdrant-clients-sdk/SKILL.md by harness/claude-code/scripts/convert_from_copilot.py. Edit the source, not this file. -->78# Qdrant clients SDK910Use the official Qdrant clients and API references to answer SDK questions, choose an integration path, and fetch curated snippets for concrete operations such as collection creation, vector search, payload filtering, and point upload.1112## When to invoke1314- "Which Qdrant client should I install for this language?"15- "Show the Qdrant API reference for uploading points."16- "Find a Qdrant snippet for TypeScript vector search."17- "Should I use Qdrant REST or gRPC?"18- "Install the Qdrant Python client with FastEmbed."1920## Official clients and installs2122| Language | Official SDK | Install command or source |23| --- | --- | --- |24| Python | `qdrant-client` | `pip install qdrant-client[fastembed]` from `https://github.com/qdrant/qdrant-client` |25| JavaScript / TypeScript | `qdrant-js` | `npm install @qdrant/js-client-rest` from `https://github.com/qdrant/qdrant-js` |26| Rust | `rust-client` | `cargo add qdrant-client` from `https://github.com/qdrant/rust-client` |27| Go | `go-client` | `go get github.com/qdrant/go-client` from `https://github.com/qdrant/go-client` |28| .NET | `qdrant-dotnet` | `dotnet add package Qdrant.Client` from `https://github.com/qdrant/qdrant-dotnet` |29| Java | `java-client` | Maven Central artifact `io.qdrant/client` at `https://central.sonatype.com/artifact/io.qdrant/client` and source `https://github.com/qdrant/java-client` |3031## API surfaces3233| Surface | Use when | Reference |34| --- | --- | --- |35| REST API | You are new to Qdrant, prototyping, debugging with HTTP, or need OpenAPI-generated clients. | OpenAPI Reference `https://api.qdrant.tech/api-reference`; OpenAPI JSON `https://github.com/qdrant/qdrant/blob/master/docs/redoc/master/openapi.json` |36| gRPC API | You need lower overhead, streaming-friendly integrations, or native generated protobuf clients. | gRPC protobuf definitions `https://github.com/qdrant/qdrant/tree/master/lib/api/src/grpc/proto` |37| Curated snippets | You need operation-level examples before writing code. | `https://snippets.qdrant.tech/search?language=python&query=how+to+upload+points` |3839## Snippet search workflow40411. Choose one supported snippet language: `python`, `typescript`, `rust`, `java`, `go`, or `csharp`.422. Convert the user's intent into a concise query such as `how to upload points`, `hybrid search`, or `filter by payload`.433. Fetch snippets with `curl -X GET "https://snippets.qdrant.tech/search?language=<language>&query=<url-encoded-query>"`.444. Add `&format=json` only when structured snippet output is required; otherwise keep the default markdown response.455. Preserve version notes such as `vlatest`, source URLs, idempotency comments, and retry flags from the snippet.4647## Point upload reference pattern4849When a snippet teaches point upload, preserve these API names and behaviors in generated code or advice:5051| Concept | API or value | Rule |52| --- | --- | --- |53| Python client method | `client.upload_points(...)` from `qdrant_client` | Use for uploading multiple vector-embedded points to a collection. |54| Point type | `models.PointStruct` | Include `id`, `payload`, and `vector`. |55| Collection argument | `collection_name="{collection_name}"` | Replace `{collection_name}` with the real collection. |56| Example payload | `payload={"color": "red"}` and `payload={"color": "green"}` | Payloads are metadata for filtering. |57| Example vectors | `vector=[0.9, 0.1, 0.1]` and `vector=[0.1, 0.9, 0.1]` | Use dimensionality that matches the collection schema. |58| Reliability flags | `parallel=4`, `max_retries=3` | Mention when preserving robust indexing behavior. |59| Idempotency | Re-uploading and re-uploading the same `id` overwrites existing points. | If ids are omitted, Qdrant auto-generates UUIDs. |60| Documentation source | `https://qdrant.tech/documentation/manage-data/points/` | Cite when discussing point management. |6162## Output template6364```markdown65## Qdrant SDK answer6667**Status:** ready | needs lookup | blocked68**Language:** `python` | `typescript` | `rust` | `java` | `go` | `csharp` | `rest` | `grpc`69**Recommended surface:** <SDK, REST API, or gRPC API>7071| Need | Command, API, or reference | Notes |72| --- | --- | --- |73| Install | `<install command>` | <package/source> |74| Example | `<method or endpoint>` | <snippet source or caveat> |75| Validation | `<command or check>` | <expected result> |76```7778## Quality gate7980- [ ] The recommended client is one of the officially supported SDKs listed above.81- [ ] Installation commands match the selected language exactly.82- [ ] REST is preferred for first-time or prototype usage unless the user needs gRPC.83- [ ] Snippet searches use only supported languages and URL-encoded queries.84- [ ] API names from snippets, such as `PointStruct`, `upload_points`, `parallel`, and `max_retries`, are preserved when relevant.85- [ ] Absolute Qdrant reference URLs are included when citing API documentation.8687## References8889- [Qdrant Python client](https://github.com/qdrant/qdrant-client)90- [Qdrant JavaScript/TypeScript client](https://github.com/qdrant/qdrant-js)91- [Qdrant Rust client](https://github.com/qdrant/rust-client)92- [Qdrant Go client](https://github.com/qdrant/go-client)93- [Qdrant .NET client](https://github.com/qdrant/qdrant-dotnet)94- [Qdrant Java client](https://github.com/qdrant/java-client)95- [Qdrant Java Maven Central artifact](https://central.sonatype.com/artifact/io.qdrant/client)96- [Qdrant REST OpenAPI Reference](https://api.qdrant.tech/api-reference)97- [Qdrant OpenAPI JSON](https://github.com/qdrant/qdrant/blob/master/docs/redoc/master/openapi.json)98- [Qdrant gRPC protobuf definitions](https://github.com/qdrant/qdrant/tree/master/lib/api/src/grpc/proto)99- [Qdrant snippet search example](https://snippets.qdrant.tech/search?language=python&query=how+to+upload+points)100- [Qdrant point management](https://qdrant.tech/documentation/manage-data/points/)
paulasilvatech