Skip to content

v0.2.0 — Scalability + Open-Source Readiness

Choose a tag to compare

@EdgarBabajanyan EdgarBabajanyan released this 08 May 20:30
· 82 commits to main since this release
85f6462

Scalability

  • Memory-mapped vector storage (MmapVectors). Replaces Vec<Vec<f32>> with a flat mmap-backed file. Zero-copy reads, append-only writes, near-zero RSS for vector data regardless of dataset size.
  • Disk-backed chunk metadata (ChunkStore). Backed by redb (pure Rust embedded DB). Replaces in-memory HashMap<u64, DocumentChunk>.
  • Incremental HNSW indexing. Ingest path loads existing USearch index via .load(), appends with .add(), saves — no more full rebuild on every ingest.
  • New dependencies: memmap2, bytemuck, redb

Telemetry

  • Anonymous opt-out telemetry via PostHog. Sends daily heartbeat with instance UUID, version, OS, arch, collection count, total vectors. No data content or PII.
  • Opt out: COMPASS_TELEMETRY=off or DO_NOT_TRACK=1
  • Python examples (examples/python/compass_client.py) covering all API interactions.

Open-Source Readiness

  • CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
  • SECURITY.md (vulnerability disclosure policy)
  • .github/ISSUE_TEMPLATE/ (bug report, feature request)
  • .github/PULL_REQUEST_TEMPLATE.md
  • .github/CODEOWNERS
  • .github/workflows/release.yml (automated releases on tag push)
  • docker-compose.yml (local quickstart)
  • README badges (CI, license, Rust version)
  • Compass logo + Captain wordmark in README header

Changed

  • MSRV bumped to 1.88 (from 1.82). Required by time@0.3.47.
  • Dockerfile upgraded to rust:latest + debian:trixie-slim.