Skip to content

Releases: NaCode-Studios/Kdrant

v1.1.0

Choose a tag to compare

@tonytonycoder11 tonytonycoder11 released this 20 Jul 20:58
e70f540

Maintenance & compatibility release on top of 1.0.0. Kdrant's own public API is unchanged (the *.api dumps are identical, apiCheck green).

Changed

  • kdrant-spring-ai → Spring AI 2.0 and kdrant-spring-boot-starter → Spring Boot 4.1 (Spring Framework 7 / Jakarta EE 11). Verified end-to-end: the auto-configuration loads in a Boot 4 context and the VectorStore adapter passes its tests against Spring AI 2.0.
    Compatibility: applications still on Spring AI 1.x / Spring Boot 3.x should pin those two modules to 1.0.0 until they upgrade. kdrant-core and kdrant-transport-rest are unaffected.
  • kdrant-langchain4j → LangChain4j 1.18.0 — a backwards-compatible minor upgrade.

Internal / quality

  • Toolchain: Kotlin 2.4.10, Gradle 9.6.1, kotest 6.2.2, plus assorted minor/patch bumps; CI actions run on Node 24.
  • The Kotlin modules now compile with allWarningsAsErrors — every compiler deprecation fails the build, so the code stays warning-clean across future upgrades. A full clean build reports 0 Kotlin warnings.

Full changelog: https://github.com/NaCode-Studios/Kdrant/blob/main/CHANGELOG.md

1.0.0

Choose a tag to compare

@tonytonycoder11 tonytonycoder11 released this 20 Jul 18:51
071f83d

Kdrant reaches 1.0.0 — the REST core is feature-complete and the public API is now stable under SemVer (see STABILITY.md).

Highlights since 0.2.0 (M19–M24)

  • Aliases, service & analytics — atomic updateAliases { … } + listAliases / listCollectionAliases; healthz / readyz / livez, listCollections, telemetry, metrics (Prometheus), listIssues / clearIssues; facet, searchMatrixPairs / searchMatrixOffsets.
  • Snapshots & backup/restore — collection + storage scope create/list/delete/recover, with streaming binary download (Flow<ByteArray>) and multipart upload.
  • Granular transport & hot path — a configureClient seam, connectTimeout / socketTimeout, api-key-redacting logging; Flow / Sequence upsert; a FloatArray zero-boxing dense path (vector / query); byte-aware upsert batching.
  • Ecosystemkdrant-spring-boot-starter, kdrant-spring-ai (Spring AI VectorStore), kdrant-langchain4j (LangChain4j EmbeddingStore), and a runnable RAG example (example-rag).
  • Quality & supply chain — ktlint + detekt gates, a JDK 17/21 × Qdrant-version CI matrix, Gradle wrapper validation, dependency review, Dependabot, and property-based serialization tests.
  • Stability — the catching { } helper (coroutine-safe Result), a written stability/semver policy (STABILITY.md), and a JMH upsert/search latency harness (benchmarks/).

Stability

From 1.0.0 the public API — exactly what the *.api files track — is stable: no breaking change without a major bump, @Deprecated for at least one minor before removal, and every operation stays suspend / Flow with cooperative cancellation. See STABILITY.md.

Install

implementation("io.github.nacode-studios:kdrant-transport-rest:1.0.0")

Or import the BOM (io.github.nacode-studios:kdrant-bom:1.0.0) and declare the modules without versions.

Full details in CHANGELOG.md.

v0.2.0

Choose a tag to compare

@tonytonycoder11 tonytonycoder11 released this 20 Jul 11:56
33fe273

A large feature release on top of 0.1.0.

Highlights

  • Modern /points/query search — nearest, hybrid RRF/DBSF fusion, sparse & multi-vectors, recommend / discover / context, searchBatch, and searchGroups.
  • Payload & vector management — payload field indexes (createPayloadIndex / deletePayloadIndex); setPayload / overwritePayload / deletePayload / clearPayload; updateVectors / deleteVectors.
  • Collection configupdateCollection (PATCH) with optimizers / HNSW / quantization; optimizers and quantization on createCollection.
  • Typed DXkdrantJson, payloadAs<T> / searchAs<T> / Hit<T>, getCollectionOrNull, createCollectionIfNotExists.
  • Resilience — retries with exponential backoff + jitter honoring Retry-After; a finer KdrantException taxonomy (RateLimited / ServiceUnavailable / ServerError / AlreadyExists).
  • Correctness & security — the delete-by-filter data-loss fix, and TLS enforced when an API key is set.
  • A kdrant-bom module to keep the modules on one aligned version.

See the CHANGELOG for the full list, and ROADMAP.md for what's next (M19–M25).

Install

implementation("io.github.nacode-studios:kdrant-transport-rest:0.2.0")

Requires JDK 17+.

v0.1.0

Choose a tag to compare

@tonytonycoder11 tonytonycoder11 released this 10 Jul 16:47

First release of Kdrant — an idiomatic, coroutine-first Kotlin client for Qdrant.

Collections (create / delete / exists / info), upsert (dense & named vectors, payloads, auto-batching), search, scroll (as a Flow), count, retrieve, delete (by ids or filter), and a complete filter DSL — over a REST/Ktor transport behind a protocol-independent seam.

See the CHANGELOG for details.