simplevecdb 2.6.0__tar.gz → 2.6.1__tar.gz

simplevecdb-2.6.1/.github/FUNDING.yml

@@ -0,0 +1,5 @@
+github: [coderdayton]
+custom:
+  [
+    "https://ko-fi.com/xbbvii",
+  ]

simplevecdb-2.6.1/.gitignore

@@ -0,0 +1,70 @@
+# Python / uv
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.tox/
+.nox/
+
+# Tooling caches
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.cache/
+.hypothesis/
+cython_debug/
+
+# Coverage
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+htmlcov/
+
+# Jupyter
+.ipynb_checkpoints/
+
+# Environment / secrets
+.env
+.envrc
+.direnv/
+
+# Databases (SimpleVecDB writes WAL/SHM sidecars)
+*.db
+*.db-journal
+*.db-shm
+*.db-wal
+*.sqlite
+*.sqlite3
+
+# Editor / IDE
+.vscode/
+.idea/
+.history/
+*.iml
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Docs build
+site/
+
+# Agentic CLI tools (per-developer state)
+.opencode/
+opencode.json
+.claude/
+.codex
+
+# Project-specific scratch
+simplevecdb_plan.md
+AGENTS.md
+NEXT_UPDATES.md
+pro_pack/

{simplevecdb-2.6.0 → simplevecdb-2.6.1}/CHANGELOG.md

@@ -5,6 +5,109 @@ All notable changes to SimpleVecDB will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.1] - 2026-05-10
+
+### Storage, mutation, and eventing improvements
+
+This release closes ten long-standing gaps in the catalog layer with a coherent
+set of additive primitives. No public API breaks; existing 2.6.0 databases
+upgrade transparently (the new tables are created on first open).
+
+#### New features
+
+- **Native vector update via pending buffer** — `collection.update_embedding(id, vector)`
+  writes a row to a per-collection `_pending_vectors` overlay inside one SQL
+  transaction; the new vector becomes visible to reads immediately and is
+  promoted to the HNSW index on `collection.pending.flush()`. Removes the
+  HNSW remove+re-add churn previously required for in-place updates.
+- **Bulk vector math** — `collection.pending.update_many([(id, vec), …])` and
+  `collection.pending.blend_toward(ids, centroid, alpha)` for batched edits.
+- **Atomic transaction boundary** — `with db.transaction() as tx: …` and
+  `with collection.tx(): …` wrap a SAVEPOINT around catalog writes
+  (metadata, counters, edges, events, TTL, and `update_embedding`'s
+  pending overlay) so a raised exception rolls all SQL writes back.
+  Coarse vector mutations (`add_texts`, `delete`) are NOT rolled back —
+  use `update_embedding` + `pending.flush()` for vector changes that
+  must be commit-gated. Nested contexts share a single savepoint stack
+  via the new `_TxState` helper.
+- **Weighted directed edges** — new `collection.edges` namespace with
+  `add_edge / get_edges / update_edge / delete_edge / prune` over a
+  per-collection `_edges` table. Numeric columns (`weight`, `bonus`, `hits`,
+  `last_touch`) are addressable by the new range-filter grammar; deltas
+  (`dweight=+0.02, dhits=+1`) compile to a single atomic SQL UPDATE.
+- **Atomic counter increments** — `collection.increment_metadata(id, {"hits": 1, "drift": 0.02})`
+  applies a dict of numeric deltas to JSON metadata in one statement using
+  chained `json_set(... json_extract + ?)` calls. WAL-atomic; safe under
+  concurrent writers.
+- **Mongo-style range filters** — `filter={"score": {"$gt": 0.5, "$lte": 0.9}}`
+  on `similarity_search`, `keyword_search`, `hybrid_search`, `edges.get_edges`,
+  and `events.read`. Supported operators: `$eq $ne $gt $gte $lt $lte $in $nin
+  $exists $between`. Tuple shorthand (`("range", lo, hi)`, `(">", x)`) is
+  normalised into the operator-dict form.
+- **Append-only change feed** — every mutating method now appends one row to
+  a per-collection `_events` table (kind, doc_id, payload, monotonic seq).
+  `collection.events.read(since=, kind=, limit=)`,
+  `collection.events.subscribe(since=, poll_interval=)`, and
+  `collection.events.prune(before_seq=)` expose the feed; cross-process
+  visibility comes from the existing WAL mode.
+- **TTL / expiry hooks** — `collection.ttl.set(id, seconds=…, on_expire="delete"|"callback")`,
+  `collection.ttl.clear(id)`, and `collection.ttl.sweep()` over a
+  `_ttl` table; `start_background(interval=…)` runs the sweep in a daemon
+  thread (off by default).
+- **Incremental rebuild scheduler** — `collection.maintenance.rebuild_if_needed(max_pending=, max_deleted=)`
+  triggers a full `rebuild_index()` only when the configured pending /
+  tombstone / wall-time thresholds are crossed.
+- **Multi-process write safety** — added `PRAGMA busy_timeout=5000` and
+  `PRAGMA foreign_keys=ON` at every connection-open site (encrypted and
+  unencrypted). The native 5 s wait window reduces `DatabaseLockedError`
+  pressure under contention; foreign keys cascade-delete pending /
+  edges / TTL rows when a doc is deleted. The events table is
+  intentionally FK-less so the audit trail survives deletions.
+- **Async wrappers** — `AsyncVectorCollection` gains async equivalents of the
+  new methods (`update_embedding`, `flush_pending`, `increment_metadata`,
+  `add_edge`, `update_edge`, `delete_edge`, `get_edges`, `set_ttl`,
+  `clear_ttl`, `sweep_ttl`, `read_events`, `last_event_seq`,
+  `rebuild_if_needed`).
+
+#### New types & constants
+
+- `simplevecdb.types`: `Edge`, `Event`, `TTLEntry` frozen dataclasses.
+- `simplevecdb.constants`: `PENDING_FLUSH_DEFAULT_BATCH=1000`,
+  `EVENTS_POLL_INTERVAL_S=0.1`, `EVENTS_RETENTION_LIMIT=100_000`,
+  `TTL_SWEEP_DEFAULT_INTERVAL_S=60.0`, `REBUILD_PENDING_THRESHOLD=5_000`,
+  `REBUILD_TOMBSTONE_THRESHOLD=5_000`, `REBUILD_MIN_INTERVAL_S=3600.0`,
+  `SQLITE_BUSY_TIMEOUT_MS=5000`.
+
+#### Test coverage
+
+- `tests/unit/test_v26_1_features.py` — 25 tests covering the five must-have
+  primitives end-to-end: `update_embedding` + pending buffer + flush; edges
+  CRUD with atomic deltas, range filtering, and prune; `increment_metadata`
+  under 800-thread contention (exact total preserved); transaction rollback
+  and commit semantics; Mongo-style and tuple-shorthand range filters in
+  `similarity_search`; events append on every mutation; TTL sweep with
+  `delete` and `callback` paths; threshold-driven rebuild scheduler.
+
+#### Removed
+
+- **`sqlite-vec` dependency** dropped from `pyproject.toml`. The package was
+  never imported and the v1.x → v2.0 auto-migration code path could not have
+  worked without explicitly loading the extension at connection time.
+- **`MigrationRequiredError`**, **`VectorDB.check_migration()`**, and the
+  **`auto_migrate=`** constructor flag have been removed. Databases written
+  by `simplevecdb < 2.0.0` (sqlite-vec backend) are no longer auto-migrated
+  on open. To upgrade a v1.x database, dump the rows with a v1.x install and
+  re-ingest them through the v2 API; or stay on the last release that shipped
+  the migration path (anything ≤ v2.6.1's predecessor).
+- The catalog helpers `check_legacy_sqlite_vec`, `get_legacy_vectors`, and
+  `drop_legacy_vec_table` are gone alongside the migration entry point.
+
+#### Out of scope
+
+- No external pub/sub for events — polling only.
+- No multi-master writer support; single-writer + many readers remains the
+  recommended topology.
+
 ## [2.6.0] - 2026-05-06
 
 ### Review pass 3 — final correctness/security pass before tag

simplevecdb-2.6.1/PKG-INFO

@@ -0,0 +1,377 @@
+Metadata-Version: 2.4
+Name: simplevecdb
+Version: 2.6.1
+Summary: Dead-simple local vector database powered by usearch HNSW.
+Project-URL: Homepage, https://github.com/CoderDayton/simplevecdb
+Project-URL: Repository, https://github.com/CoderDayton/simplevecdb
+Project-URL: Issues, https://github.com/CoderDayton/simplevecdb/issues
+Project-URL: Changelog, https://github.com/CoderDayton/simplevecdb/blob/main/CHANGELOG.md
+Author-email: Dayton Dunbar <coderdayton14@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: embeddings,hnsw,langchain,llamaindex,rag,similarity-search,sqlite,usearch,vector-database,vectordb
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=41.0
+Requires-Dist: hdbscan>=0.8.33
+Requires-Dist: numpy>=1.24
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: scikit-learn>=1.3.0
+Requires-Dist: sqlcipher3-binary>=0.5.0
+Requires-Dist: usearch>=2.16.3
+Provides-Extra: examples
+Requires-Dist: ollama; extra == 'examples'
+Provides-Extra: integrations
+Requires-Dist: langchain-core>=1.0.7; extra == 'integrations'
+Requires-Dist: langchain-openai>=1.0.3; extra == 'integrations'
+Requires-Dist: llama-index-llms-ollama>=0.9.0; extra == 'integrations'
+Requires-Dist: llama-index-llms-openai-like>=0.5.3; extra == 'integrations'
+Requires-Dist: llama-index>=0.14.8; extra == 'integrations'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: sentence-transformers>=5.0; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'server'
+Description-Content-Type: text/markdown
+
+# SimpleVecDB
+
+[![CI](https://github.com/coderdayton/simplevecdb/actions/workflows/ci.yml/badge.svg)](https://github.com/coderdayton/simplevecdb/actions)
+[![PyPI](https://img.shields.io/pypi/v/simplevecdb?color=blue)](https://pypi.org/project/simplevecdb/)
+[![License: MIT](https://img.shields.io/github/license/coderdayton/simplevecdb)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/coderdayton/simplevecdb?style=social)](https://github.com/coderdayton/simplevecdb)
+
+<a href='https://ko-fi.com/U7U01WTJF9' target='_blank'><img height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi3.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /></a>
+
+**The dead-simple, local-first vector database.**
+
+SimpleVecDB brings **Chroma-like simplicity** to a single **SQLite file**. Built on `usearch` HNSW indexing, it offers high-performance vector search, quantization, and zero infrastructure headaches. Perfect for local RAG, offline agents, and indie hackers who need production-grade vector search without the operational overhead.
+
+## Why SimpleVecDB?
+
+- **Zero Infrastructure** — Just a `.db` file. No Docker, no Redis, no cloud bills.
+- **Blazing Fast** — 10-100x faster search via usearch HNSW. Adaptive: brute-force for <10k vectors (perfect recall), HNSW for larger collections.
+- **Truly Portable** — Runs anywhere SQLite runs: Linux, macOS, Windows, even WASM.
+- **Async Ready** — Full async/await support with optional executor injection for thread-safe ONNX/usearch sharing.
+- **Batteries Included** — Optional FastAPI embeddings server + LangChain/LlamaIndex integrations via `[integrations]` extra.
+- **Production Ready** — Hybrid search (BM25 + vector), metadata filtering, multi-collection support, and automatic hardware acceleration.
+
+### When to Choose SimpleVecDB
+
+| Use Case                       | SimpleVecDB           | Cloud Vector DB          |
+| :----------------------------- | :-------------------- | :----------------------- |
+| **Local RAG applications**     | ✅ Perfect fit        | ❌ Overkill + latency    |
+| **Offline-first agents**       | ✅ No internet needed | ❌ Requires connectivity |
+| **Prototyping & MVPs**         | ✅ Zero config        | ⚠️ Setup overhead        |
+| **Multi-tenant SaaS at scale** | ⚠️ Consider sharding  | ✅ Built for this        |
+| **Budget-conscious projects**  | ✅ $0/month           | ❌ $50-500+/month        |
+
+## Prerequisites
+
+**System Requirements:**
+
+- Python 3.10+
+- SQLite 3.35+ with FTS5 support (included in Python 3.8+ standard library)
+- 50MB+ disk space for core library, 500MB+ with `[server]` extras
+
+**Optional for GPU Acceleration:**
+
+- CUDA 11.8+ for NVIDIA GPUs
+- Metal Performance Shaders (MPS) for Apple Silicon
+
+> **Note:** If using custom-compiled SQLite, ensure `-DSQLITE_ENABLE_FTS5` is enabled for full-text search support.
+
+## Installation
+
+```bash
+# Standard installation (includes clustering, encryption)
+pip install simplevecdb
+
+# With LangChain & LlamaIndex integrations
+pip install "simplevecdb[integrations]"
+
+# With local embeddings server (adds 500MB+ models)
+pip install "simplevecdb[server]"
+```
+
+**What's included by default:**
+- Vector search with HNSW indexing
+- Clustering (K-means, MiniBatch K-means, HDBSCAN)
+- Encryption (SQLCipher AES-256)
+- Async support
+
+**Verify Installation:**
+
+```bash
+python -c "from simplevecdb import VectorDB; print('SimpleVecDB installed successfully!')"
+```
+
+## Quickstart
+
+SimpleVecDB is just a storage and search layer — it doesn't ship an LLM
+and won't generate embeddings for you. Bring whichever embedding source
+you already use; three common ones below.
+
+### Option 1: OpenAI embeddings
+
+```python
+from simplevecdb import VectorDB
+from openai import OpenAI
+
+client = OpenAI()
+db = VectorDB("notes.db")
+notes = db.collection("personal")
+
+def embed(text: str) -> list[float]:
+    return (
+        client.embeddings
+        .create(model="text-embedding-3-small", input=text)
+        .data[0].embedding
+    )
+
+entries = [
+    ("Cherry MX silent reds bottom out around 45g — quieter than browns", "keyboards"),
+    ("Sourdough hydration sweet spot is ~75% with this flour",            "baking"),
+    ("EXPLAIN ANALYZE showed seq scan; ANALYZE on the table fixed it",    "work"),
+    ("Passport renewal took 3 weeks, not the advertised 6–8",             "admin"),
+]
+
+notes.add_texts(
+    texts=[t for t, _ in entries],
+    embeddings=[embed(t) for t, _ in entries],
+    metadatas=[{"tag": tag} for _, tag in entries],
+)
+
+hits = notes.similarity_search(embed("how loud are silent reds"), k=2)
+for doc, score in hits:
+    print(f"{score:.3f}  {doc.page_content}")
+
+work = notes.similarity_search(
+    embed("query plan slow"),
+    k=5,
+    filter={"tag": "work"},
+)
+```
+
+### Option 2: Fully local (no network, no API key)
+
+```bash
+pip install "simplevecdb[server]"
+```
+
+```python
+from simplevecdb import VectorDB
+from simplevecdb.embeddings.models import embed_texts
+
+db = VectorDB("notes.db")
+notes = db.collection("personal")
+
+texts = [
+    "Cherry MX silent reds bottom out around 45g",
+    "Sourdough hydration sweet spot is ~75% with this flour",
+    "EXPLAIN ANALYZE showed seq scan; ANALYZE on the table fixed it",
+]
+notes.add_texts(texts=texts, embeddings=embed_texts(texts))
+
+vec = notes.similarity_search(embed_texts(["quieter switches"])[0], k=2)
+mixed = notes.hybrid_search("postgres slow query", k=3)
+```
+
+If you'd rather hit an HTTP endpoint than import the embedding models
+directly, the bundled server speaks the same shape as OpenAI's
+embeddings API:
+
+```bash
+simplevecdb-server --port 8000                # default model, auto warm-up
+simplevecdb-server --host 0.0.0.0 --port 9000
+simplevecdb-server --no-warmup                # skip the model preload
+simplevecdb-server --help
+```
+
+Server tuning (model registry, rate limits, API keys, CORS, CUDA) lives
+in the [Setup Guide](ENV_SETUP.md).
+
+### Option 3: LangChain or LlamaIndex
+
+Already wired into one of the big RAG frameworks? Drop SimpleVecDB in
+as the vector store:
+
+```bash
+pip install "simplevecdb[integrations]"
+```
+
+```python
+from simplevecdb.integrations.langchain import SimpleVecDBVectorStore
+from langchain_openai import OpenAIEmbeddings
+
+store = SimpleVecDBVectorStore(
+    db_path="notes.db",
+    embedding=OpenAIEmbeddings(model="text-embedding-3-small"),
+)
+
+store.add_texts([
+    "Cherry MX silent reds bottom out around 45g",
+    "EXPLAIN ANALYZE showed seq scan; ANALYZE on the table fixed it",
+])
+store.similarity_search("quieter switches", k=1)
+store.hybrid_search("postgres performance", k=3)
+```
+
+LlamaIndex is the same shape:
+
+```python
+from simplevecdb.integrations.llamaindex import SimpleVecDBLlamaStore
+from llama_index.embeddings.openai import OpenAIEmbedding
+
+store = SimpleVecDBLlamaStore(
+    db_path="notes.db",
+    embedding=OpenAIEmbedding(model="text-embedding-3-small"),
+)
+```
+
+End-to-end notebooks (including a fully local Ollama RAG) live in the
+[examples gallery](https://coderdayton.github.io/SimpleVecDB/examples/).
+
+## Feature Highlights
+
+A few of the things SimpleVecDB does well — see
+[`docs/Features.md`](docs/Features.md) for the comprehensive list.
+
+- **Vector + keyword + hybrid search** — cosine / L2 similarity, BM25
+  via SQLite FTS5, and Reciprocal Rank Fusion in one collection.
+- **Adaptive HNSW** — brute-force for <10k vectors (perfect recall),
+  `usearch` HNSW above that. Override per query with `exact=True/False`.
+- **Quantization** — `FLOAT32`, `FLOAT16`, `INT8`, `BIT` for 1×–32×
+  compression.
+- **Multi-collection + cross-collection search** — isolated namespaces in
+  one `.db` file, with merged ranked search across them.
+- **Mongo-style filters** — `$eq $ne $gt $gte $lt $lte $in $nin $exists
+  $between` on metadata, edges, and events.
+- **Memory primitives (v2.6.1)** — pending-vector buffer with atomic
+  flush, weighted directed edges, append-only event feed, TTL with
+  delete/callback sweep, and a threshold-driven rebuild scheduler.
+- **Atomic counters & transactions (v2.6.1)** — `increment_metadata` for
+  JSON deltas in one statement; SAVEPOINT-backed `db.transaction()` /
+  `collection.tx()` rolling all catalog writes back on error.
+- **Async, encryption, clustering, hierarchies** — full async surface
+  (with executor injection), SQLCipher AES-256, K-means / MiniBatch
+  K-means / HDBSCAN, parent/child relationships.
+- **Framework integrations** — drop-in `LangChain` and `LlamaIndex`
+  adapters via the `[integrations]` extra; optional FastAPI embeddings
+  server via `[server]`.
+
+For full method-level coverage, see [the Features doc](docs/Features.md)
+or the [API reference](https://coderdayton.github.io/SimpleVecDB/api/core).
+
+
+## Performance Benchmarks
+
+**10,000 vectors, 384 dimensions, k=10 search** — [Full benchmarks →](https://coderdayton.github.io/SimpleVecDB/benchmarks)
+
+| Quantization | Storage  | Query Time | Compression |
+| :----------- | :------- | :--------- | :---------- |
+| FLOAT32      | 36.0 MB  | 0.20 ms    | 1x          |
+| FLOAT16      | 28.7 MB  | 0.20 ms    | 2x          |
+| INT8         | 25.0 MB  | 0.16 ms    | 4x          |
+| BIT          | 21.8 MB  | 0.08 ms    | 32x         |
+
+**Key highlights:**
+- **3-34x faster** than brute-force for collections >10k vectors
+- **Adaptive search**: perfect recall for small collections, HNSW for large
+- **FLOAT16 recommended**: best balance of speed, memory, and precision
+
+## Documentation
+
+- **[Features](docs/Features.md)** — Comprehensive list of every capability, grouped by area
+- **[Setup Guide](https://coderdayton.github.io/SimpleVecDB/ENV_SETUP)** — Environment variables, server configuration, authentication
+- **[API Reference](https://coderdayton.github.io/SimpleVecDB/api/core)** — Complete class/method documentation with type signatures
+- **[Benchmarks](https://coderdayton.github.io/SimpleVecDB/benchmarks)** — Quantization strategies, batch sizes, hardware optimization
+- **[Integration Examples](https://coderdayton.github.io/SimpleVecDB/examples)** — RAG notebooks, Ollama workflows, production patterns
+- **[Contributing Guide](CONTRIBUTING.md)** — Development setup, testing, PR guidelines
+
+## Troubleshooting
+
+**Import Error: `sqlite3.OperationalError: no such module: fts5`**
+
+```bash
+# Your Python's SQLite was compiled without FTS5
+# Solution: Install Python from python.org (includes FTS5) or compile SQLite with:
+# -DSQLITE_ENABLE_FTS5
+```
+
+**Dimension Mismatch Error**
+
+```python
+# Ensure all vectors in a collection have identical dimensions
+collection = db.collection("docs", dim=384)  # Explicit dimension
+```
+
+**CUDA Not Detected (GPU Available)**
+
+```bash
+# Verify CUDA installation
+python -c "import torch; print(torch.cuda.is_available())"
+
+# Reinstall PyTorch with CUDA support
+pip install torch --index-url https://download.pytorch.org/whl/cu118
+```
+
+**Slow Queries on Large Datasets**
+
+- Enable quantization: `collection = db.collection("docs", quantization=Quantization.INT8)`
+- For >10k vectors, HNSW is automatic; tune with `rebuild_index(connectivity=32)`
+- Use `exact=False` to force HNSW even on smaller collections
+- Use metadata filtering to reduce search space
+
+## Roadmap
+
+What's on the near-term radar:
+
+- [ ] Incremental clustering (online learning)
+- [ ] Cluster visualization exports
+
+For shipped capabilities, see [`docs/Features.md`](docs/Features.md) and the
+release-by-release [Changelog](CHANGELOG.md). Vote on these or propose new
+ideas in [GitHub Discussions](https://github.com/coderdayton/simplevecdb/discussions).
+
+## Contributing
+
+Contributions are welcome! Whether you're fixing bugs, improving documentation, or proposing new features:
+
+1. Read [CONTRIBUTING.md](CONTRIBUTING.md) for development setup
+2. Check existing [Issues](https://github.com/coderdayton/simplevecdb/issues) and [Discussions](https://github.com/coderdayton/simplevecdb/discussions)
+3. Open a PR with clear description and tests
+
+## Community & Support
+
+**Get Help:**
+
+- [GitHub Discussions](https://github.com/coderdayton/simplevecdb/discussions) — Q&A and feature requests
+- [GitHub Issues](https://github.com/coderdayton/simplevecdb/issues) — Bug reports
+
+**Stay Updated:**
+
+- [GitHub Releases](https://github.com/coderdayton/simplevecdb/releases) — Changelog and updates
+- [Examples Gallery](https://coderdayton.github.io/SimpleVecDB/examples/) — Community-contributed notebooks
+
+## Other Ways to Support
+
+- ☕ **[Buy me a coffee](https://ko-fi.com/xbbvii)** - One-time donation
+- ⭐ **Star the repo** - Helps with visibility
+- 🐛 **Report bugs** - Improve the project for everyone
+- 📝 **Contribute** - See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## License
+
+[MIT License](LICENSE) — Free for personal and commercial use.