Skip to content

giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-java/skills/qdrant

qdrant

Verified

Provides Qdrant vector database integration patterns with LangChain4j. Handles embedding storage, similarity search, and vector management for Java applications. Use when implementing vector-based retrieval for RAG systems, semantic search, or recommendation engines.

FileKindSize
SKILL.mdskill md6.4 KB
references/examples.mdmarkdown17.0 KB
references/references.mdmarkdown3.7 KB

references/references.md

View on GitHub
# Qdrant for Java: References

This file contains key technical details and code patterns for integrating Qdrant with Java applications.

## Qdrant Java Client API Reference

### Core Setup

**Maven:**
```xml
<dependency>
    <groupId>io.qdrant</groupId>
    <artifactId>client</artifactId>
    <version>1.15.0</version>
</dependency>
```

**Gradle:**
```gradle
implementation 'io.qdrant:client:1.15.0'
```

### Client Initialization

```java
// Basic client
QdrantClient client = new QdrantClient(
    QdrantGrpcClient.newBuilder("localhost").build());

// Advanced client with TLS and API key
ManagedChannel channel = Grpc.newChannelBuilder(
    "localhost:6334",
    TlsChannelCredentials.newBuilder()
        .trustManager(new File("ssl/ca.crt"))
        .build()).build();

QdrantClient client = new QdrantClient(
    QdrantGrpcClient.newBuilder(channel)
        .withApiKey("<apikey>")
        .build());
```

### Collection Management

```java
// Create collection
client.createCollectionAsync("my_collection",
    VectorParams.newBuilder()
        .setDistance(Distance.Cosine)
        .setSize(4)
        .build()).get();

// Create collection with configuration
client.createCollectionAsync("my_collection",
    VectorParams.newBuilder()
        .setDistance(Distance.Cosine)
        .setSize(384)
        .build())
    .get();
```

### Point Operations

```java
// Insert points
List<PointStruct> points = List.of(
    PointStruct.newBuilder()
        .setId(id(1))
        .setVectors(vectors(0.32f, 0.52f, 0.21f, 0.52f))
        .putAllPayload(Map.of("color", value("red")))
        .build()
);

UpdateResult result = client.upsertAsync("my_collection", points).get();
```

### Search Operations

```java
// Simple search
List<ScoredPoint> results = client.searchAsync(
    SearchPoints.newBuilder()
        .setCollectionName("my_collection")
        .addAllVector(List.of(0.6235f, 0.123f, 0.532f, 0.123f))
        .setLimit(5)
        .build()).get();

// Filtered search
List<ScoredPoint> filteredResults = client.searchAsync(
    SearchPoints.newBuilder()
        .setCollectionName("my_collection")
        .addAllVector(List.of(0.6235f, 0.123f, 0.532f, 0.123f))
        .setFilter(Filter.newBuilder()
            .addMust(range("rand_number",
                Range.newBuilder().setGte(3).build()))
            .build())
        .setLimit(5)
        .build()).get();
```

## LangChain4j Integration Patterns

### QdrantEmbeddingStore Setup

```xml
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-qdrant</artifactId>
    <version>1.7.0</version>
</dependency>
```

### Configuration

```java
EmbeddingStore<TextSegment> embeddingStore = QdrantEmbeddingStore.builder()
    .collectionName("YOUR_COLLECTION_NAME")
    .host("YOUR_HOST_URL")
    .port(6334)
    .apiKey("YOUR_API_KEY")
    .build();

// Or with HTTPS
EmbeddingStore<TextSegment> embeddingStore = QdrantEmbeddingStore.builder()
    .collectionName("YOUR_COLLECTION_NAME")
    .host("YOUR_HOST_URL")
    .port(443)
    .useHttps(true)
    .apiKey("YOUR_API_KEY")
    .build();
```

## Official Documentation Resources

- **[Qdrant Documentation](https://qdrant.tech/documentation/)**: Main documentation portal
- **[Qdrant Java Client GitHub](https://github.com/qdrant/java-client)**: Source code and issues
- **[Java Client Javadoc](https://qdrant.github.io/java-client/)**: Complete API documentation
- **[API & SDKs](https://qdrant.tech/documentation/interfaces/)**: All supported clients
- **[Quickstart Guide](https://qdrant.tech/documentation/quickstart/)**: Local setup guide
- **[LangChain4j Official Site](https://langchain4j.dev/)**: Framework documentation
- **[LangChain4j Examples](https://github.com/langchain4j/langchain4j-examples)**: Comprehensive examples
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall