humemdb 0.1.0.dev0__tar.gz → 0.1.0.dev2__tar.gz

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/.github/workflows/build-docs.yml

@@ -45,5 +45,6 @@ jobs:
       - name: Build docs
         env:
           MIKE_VERSION: dev
+          MIKE_VERSION_TAG: main
         run: |
           uv run mkdocs build --strict

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/.github/workflows/deploy-docs.yml

@@ -68,9 +68,12 @@ jobs:
           fi
 
           VERSION="${RAW_VERSION#v}"
+          VERSION_TAG="v$VERSION"
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "version_tag=$VERSION_TAG" >> "$GITHUB_OUTPUT"
           echo "set_latest=$SET_LATEST" >> "$GITHUB_OUTPUT"
           echo "Deploying documentation version: $VERSION"
+          echo "Using source tag ref: $VERSION_TAG"
 
       - name: Checkout humemai-docs
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
@@ -90,6 +93,7 @@ jobs:
         working-directory: humemai-docs
         env:
           MIKE_VERSION: ${{ steps.version.outputs.version }}
+          MIKE_VERSION_TAG: ${{ steps.version.outputs.version_tag }}
         run: |
           uv run --project .. mike deploy --update-aliases \
             --deploy-prefix humemdb \
@@ -110,6 +114,7 @@ jobs:
         working-directory: humemai-docs
         env:
           MIKE_VERSION: ${{ steps.version.outputs.version }}
+          MIKE_VERSION_TAG: ${{ steps.version.outputs.version_tag }}
         run: |
           uv run --project .. mike deploy \
             --deploy-prefix humemdb \

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/.github/workflows/publish-pypi.yml

@@ -57,9 +57,13 @@ jobs:
           name: python-package-distributions
           path: dist/
 
+  examples:
+    name: Run examples
+    uses: ./.github/workflows/test-examples.yml
+
   publish:
     name: Publish package to PyPI
-    needs: build
+    needs: [build, examples]
     if: startsWith(github.ref, 'refs/tags/v')
     runs-on: ubuntu-24.04
     environment: pypi

humemdb-0.1.0.dev2/.github/workflows/test-examples.yml

@@ -0,0 +1,81 @@
+name: Test Examples
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'examples/**'
+      - 'src/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'scripts/release/run_examples.py'
+      - '.github/workflows/test-examples.yml'
+  pull_request:
+    paths:
+      - 'examples/**'
+      - 'src/**'
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - 'scripts/release/run_examples.py'
+      - '.github/workflows/test-examples.yml'
+  workflow_call:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test-examples:
+    name: Test Examples (${{ matrix.platform }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.runs-on }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - '3.10'
+          - '3.11'
+          - '3.12'
+          - '3.13'
+          - '3.14'
+        platform:
+          - 'linux/amd64'
+          - 'linux/arm64'
+          - 'darwin/arm64'
+          - 'windows/amd64'
+        include:
+          - platform: 'linux/amd64'
+            runs-on: ubuntu-24.04
+          - platform: 'linux/arm64'
+            runs-on: ubuntu-24.04-arm
+          - platform: 'darwin/arm64'
+            runs-on: macos-15
+          - platform: 'windows/amd64'
+            runs-on: windows-2025
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+
+      - name: Set up Python
+        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build distributions
+        shell: bash
+        run: |
+          uv run --with build python -m build
+
+      - name: Install built wheel
+        shell: bash
+        run: |
+          uv pip install --system dist/*.whl
+
+      - name: Run examples
+        shell: bash
+        run: |
+          python scripts/release/run_examples.py

humemdb-0.1.0.dev2/.github/workflows/test.yml

@@ -0,0 +1,59 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test (${{ matrix.platform }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.runs-on }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version:
+          - '3.10'
+          - '3.11'
+          - '3.12'
+          - '3.13'
+          - '3.14'
+        platform:
+          - 'linux/amd64'
+          - 'linux/arm64'
+          - 'darwin/arm64'
+          - 'windows/amd64'
+        include:
+          - platform: 'linux/amd64'
+            runs-on: ubuntu-24.04
+          - platform: 'linux/arm64'
+            runs-on: ubuntu-24.04-arm
+          - platform: 'darwin/arm64'
+            runs-on: macos-15
+          - platform: 'windows/amd64'
+            runs-on: windows-2025
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+
+      - name: Set up Python
+        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install project
+        run: |
+          uv sync
+
+      - name: Run tests
+        run: |
+          uv run python -m unittest discover -s tests -v

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: humemdb
-Version: 0.1.0.dev0
+Version: 0.1.0.dev2
 Summary: Embedded multi-model database orchestration over SQLite, DuckDB, Cypher, and exact and ANN vector search
 Project-URL: Homepage, https://github.com/humemai/humemdb
 Project-URL: Documentation, https://docs.humem.ai/humemdb/
@@ -36,10 +36,13 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.14
 Classifier: Topic :: Database
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Requires-Dist: duckdb<2,>=1.4
 Requires-Dist: lancedb<1,>=0.27
 Requires-Dist: numpy<3,>=2
@@ -53,6 +56,7 @@ Multi-model embedded data orchestration for SQL, Cypher, and vector search.
 
 [![Docs](https://img.shields.io/badge/docs-humem.ai-0f766e)](https://docs.humem.ai/humemdb/)
 [![Test](https://github.com/humemai/humemdb/actions/workflows/test.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/test.yml)
+[![Examples](https://github.com/humemai/humemdb/actions/workflows/test-examples.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/test-examples.yml)
 [![Build Docs](https://github.com/humemai/humemdb/actions/workflows/build-docs.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/build-docs.yml)
 [![Publish PyPI](https://github.com/humemai/humemdb/actions/workflows/publish-pypi.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/publish-pypi.yml)
 
@@ -100,6 +104,8 @@ Current behavior is intentionally explicit:
 
 ## Install
 
+HumemDB supports Python 3.10 and newer.
+
 Install from source:
 
 ```bash
@@ -131,6 +137,21 @@ uv sync
 `uv lock` updates the lockfile with exact resolved versions. `uv sync` installs that
 exact environment.
 
+## Libraries HumemDB relies on
+
+HumemDB is a pure Python orchestration layer, but it relies on a small set of core
+Python libraries and embedded engines:
+
+- `sqlite3` from the Python standard library for the canonical local write path.
+- `duckdb` for analytical reads over the SQLite-backed source-of-truth database.
+- `numpy` for the exact in-memory vector search baseline.
+- `sqlglot[c]` for the current PostgreSQL-like SQL translation layer.
+- `lancedb` for benchmark work and future indexed ANN paths.
+- `threadpoolctl` for thread-pool coordination around compute-heavy dependencies.
+
+Those dependencies are part of the public runtime story. HumemDB does not try to hide
+them behind a fake "single engine" narrative.
+
 ## 🧠 What is supported today
 
 ### SQL
@@ -180,14 +201,14 @@ with HumemDB("app.sqlite3", "analytics.duckdb") as db:
     print(result.rows)
 ```
 
-More examples live in the docs site.
+More examples live in [examples/](examples/) and in the docs site.
 
 ## 🔗 Quick links
 
 - Docs: [docs.humem.ai/humemdb](https://docs.humem.ai/humemdb/)
 - Repository: [github.com/humemai/humemdb](https://github.com/humemai/humemdb)
 - Issues: [github.com/humemai/humemdb/issues](https://github.com/humemai/humemdb/issues)
-- Internal phase tracking: [things-to-do.md](things-to-do.md)
+- Internal roadmap notes: [things-to-do.md](things-to-do.md)
 
 ## 📦 Packaging
 
@@ -197,9 +218,15 @@ side.
 
 ## 🗺️ Planning
 
-The detailed internal roadmap and phase tracking now live in `things-to-do.md` instead
-of this README.
+Detailed internal roadmap notes now live in `things-to-do.md` instead of this README.
 
 ## 📄 License
 
-MIT.
+HumemDB's own source code is licensed under MIT. See [LICENSE](LICENSE).
+
+Third-party dependencies keep their own licenses. Installing HumemDB may also install
+third-party Python packages and, in some cases, their native wheels. Those components
+are not relicensed under MIT just because HumemDB depends on them.
+
+For the concrete dependency set, see [pyproject.toml](pyproject.toml) and
+[uv.lock](uv.lock).

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/README.md

@@ -4,6 +4,7 @@ Multi-model embedded data orchestration for SQL, Cypher, and vector search.
 
 [![Docs](https://img.shields.io/badge/docs-humem.ai-0f766e)](https://docs.humem.ai/humemdb/)
 [![Test](https://github.com/humemai/humemdb/actions/workflows/test.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/test.yml)
+[![Examples](https://github.com/humemai/humemdb/actions/workflows/test-examples.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/test-examples.yml)
 [![Build Docs](https://github.com/humemai/humemdb/actions/workflows/build-docs.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/build-docs.yml)
 [![Publish PyPI](https://github.com/humemai/humemdb/actions/workflows/publish-pypi.yml/badge.svg)](https://github.com/humemai/humemdb/actions/workflows/publish-pypi.yml)
 
@@ -51,6 +52,8 @@ Current behavior is intentionally explicit:
 
 ## Install
 
+HumemDB supports Python 3.10 and newer.
+
 Install from source:
 
 ```bash
@@ -82,6 +85,21 @@ uv sync
 `uv lock` updates the lockfile with exact resolved versions. `uv sync` installs that
 exact environment.
 
+## Libraries HumemDB relies on
+
+HumemDB is a pure Python orchestration layer, but it relies on a small set of core
+Python libraries and embedded engines:
+
+- `sqlite3` from the Python standard library for the canonical local write path.
+- `duckdb` for analytical reads over the SQLite-backed source-of-truth database.
+- `numpy` for the exact in-memory vector search baseline.
+- `sqlglot[c]` for the current PostgreSQL-like SQL translation layer.
+- `lancedb` for benchmark work and future indexed ANN paths.
+- `threadpoolctl` for thread-pool coordination around compute-heavy dependencies.
+
+Those dependencies are part of the public runtime story. HumemDB does not try to hide
+them behind a fake "single engine" narrative.
+
 ## 🧠 What is supported today
 
 ### SQL
@@ -131,14 +149,14 @@ with HumemDB("app.sqlite3", "analytics.duckdb") as db:
     print(result.rows)
 ```
 
-More examples live in the docs site.
+More examples live in [examples/](examples/) and in the docs site.
 
 ## 🔗 Quick links
 
 - Docs: [docs.humem.ai/humemdb](https://docs.humem.ai/humemdb/)
 - Repository: [github.com/humemai/humemdb](https://github.com/humemai/humemdb)
 - Issues: [github.com/humemai/humemdb/issues](https://github.com/humemai/humemdb/issues)
-- Internal phase tracking: [things-to-do.md](things-to-do.md)
+- Internal roadmap notes: [things-to-do.md](things-to-do.md)
 
 ## 📦 Packaging
 
@@ -148,9 +166,15 @@ side.
 
 ## 🗺️ Planning
 
-The detailed internal roadmap and phase tracking now live in `things-to-do.md` instead
-of this README.
+Detailed internal roadmap notes now live in `things-to-do.md` instead of this README.
 
 ## 📄 License
 
-MIT.
+HumemDB's own source code is licensed under MIT. See [LICENSE](LICENSE).
+
+Third-party dependencies keep their own licenses. Installing HumemDB may also install
+third-party Python packages and, in some cases, their native wheels. Those components
+are not relicensed under MIT just because HumemDB depends on them.
+
+For the concrete dependency set, see [pyproject.toml](pyproject.toml) and
+[uv.lock](uv.lock).

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/docs/development/documentation.md

@@ -22,7 +22,7 @@ The docs site is published into the shared `humemai-docs` repository under the
 
 `mike` manages versioned documentation aliases such as `latest`.
 
-## Writing rules for this phase
+## Writing rules
 
 - keep the docs aligned with the actual `v0` runtime surface
 - prefer clear boundaries over aspirational claims

humemdb-0.1.0.dev2/docs/development/licensing.md

@@ -0,0 +1,44 @@
+# Licensing
+
+## HumemDB license
+
+HumemDB's own source code is licensed under MIT.
+
+- Repository license file:
+  [LICENSE]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/LICENSE)
+- Package metadata:
+  [pyproject.toml]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/pyproject.toml)
+
+That MIT grant applies to HumemDB's code and documentation in this repository. It does
+not automatically relicense third-party dependencies.
+
+## Runtime libraries HumemDB relies on
+
+The current runtime depends on a small set of explicit Python libraries and embedded
+engines:
+
+- `sqlite3` from the Python standard library for the canonical local write path
+- `duckdb` for analytical reads
+- `numpy` for the exact in-memory vector search baseline
+- `sqlglot[c]` for the SQL translation layer
+- `lancedb` for benchmark work and future indexed ANN paths
+- `threadpoolctl` for thread-pool coordination
+
+HumemDB intentionally presents those libraries as part of the implementation story
+instead of pretending everything comes from one hidden backend.
+
+## Third-party licenses
+
+Third-party dependencies keep their own licenses and distribution terms.
+
+- Installing HumemDB may download third-party wheels or source distributions.
+- Some of those dependencies may include native code or platform-specific wheels.
+- Those components remain under their upstream licenses.
+
+For the concrete dependency set used by this project, see:
+
+- [pyproject.toml]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/pyproject.toml)
+- [uv.lock]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/uv.lock)
+
+If you need a formal license review for a deployment, review the resolved dependency
+set from the lockfile rather than only the top-level MIT license.

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/docs/development/release.md

@@ -1,6 +1,6 @@
 # Release Workflow
 
-Phase 6 hardens the public release path around two outputs:
+HumemDB's public release path currently centers on two outputs:
 
 - the PyPI package
 - the versioned docs site

humemdb-0.1.0.dev2/docs/examples/01_sql_basics.md

@@ -0,0 +1,67 @@
+# 01 - SQL Basics
+
+[View source code]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/examples/01_sql_basics.py){ .md-button }
+
+This page documents the real repository example `examples/01_sql_basics.py`.
+
+## What the Python example does
+
+The script generates a moderately sized embedded workload instead of a tiny hand-made
+toy dataset.
+
+- 2,000 `users`
+- 50,000 `orders`
+- 2 SQLite tables
+- transactional bulk inserts through the public API
+- SQLite filtered OLTP-style reads
+- SQLite joined reads
+- DuckDB grouped analytical reads over the SQLite-backed tables
+
+## Why this example exists
+
+HumemDB is supposed to route small transactional work and broader analytical work to
+different engines explicitly. This example demonstrates that split using the actual
+public Python API.
+
+## Main operations covered
+
+- `CREATE TABLE` routed to SQLite
+- `executemany(...)` inside an explicit transaction
+- `ILIKE` translation on the SQLite route
+- SQLite join queries for row-oriented reads
+- DuckDB grouped aggregate queries for broader scans
+
+## Representative flow
+
+```python
+with HumemDB("app.sqlite3", "analytics.duckdb") as db:
+    db.query(
+        "CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, segment TEXT NOT NULL, city TEXT NOT NULL)",
+        route="sqlite",
+    )
+    db.query(
+        "CREATE TABLE orders (id INTEGER PRIMARY KEY, user_id INTEGER NOT NULL, status TEXT NOT NULL, total_cents INTEGER NOT NULL)",
+        route="sqlite",
+    )
+
+    with db.transaction(route="sqlite"):
+        db.executemany(..., users, route="sqlite")
+        db.executemany(..., orders, route="sqlite")
+
+    sqlite_rows = db.query(..., route="sqlite")
+    duckdb_rollup = db.query(..., route="duckdb")
+```
+
+## Supported statement kinds
+
+- `SELECT`
+- `INSERT`
+- `UPDATE`
+- `DELETE`
+- `CREATE`
+
+## Explicit rejections
+
+- recursive CTEs
+- unsupported PostgreSQL syntax outside the current tested surface
+- direct public writes routed to DuckDB

humemdb-0.1.0.dev2/docs/examples/02_cypher_social_graph.md

@@ -0,0 +1,57 @@
+# 02 - Cypher Social Graph
+
+[View source code]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/examples/02_cypher_social_graph.py){ .md-button }
+
+This page documents the real repository example `examples/02_cypher_social_graph.py`.
+
+## What the Python example does
+
+The script builds a generated social/work graph rather than a tiny three-node toy.
+
+- 5,000 repeated graph patterns
+- thousands of nodes
+- thousands of directed `KNOWS` edges
+- richer node properties: `name`, `age`, `active`, `cohort`, `city`
+- richer relationship properties: `since`, `strength`, and implicit `type`
+- SQLite and DuckDB graph reads over the same stored graph state
+
+## Main operations covered
+
+- repeated `CREATE` graph writes on the SQLite route
+- named parameters in Cypher `CREATE`
+- relationship alias returns
+- reverse-edge matching
+- `WHERE ... AND ...` filters
+- `ORDER BY` and `LIMIT`
+
+## Representative flow
+
+```python
+db.query(
+    (
+        "CREATE (a:User {name: $a_name, age: $a_age, active: $a_active, cohort: $cohort, city: $city})"
+        "-[r:KNOWS {since: $since_one, strength: $strength_one}]->"
+        "(b:User {name: $b_name, age: $b_age, active: $b_active, cohort: $cohort, city: $city})"
+    ),
+    route="sqlite",
+    query_type="cypher",
+    params={...},
+)
+```
+
+## Supported today
+
+- labeled node creation
+- single directed relationship creation
+- narrow `MATCH` flows
+- relationship aliases
+- reverse-edge matching
+- `WHERE` equality predicates joined by `AND`
+- `ORDER BY` and `LIMIT`
+- named parameters such as `$name`
+
+## Not promised yet
+
+HumemDB does not claim broad Cypher compatibility today. The current surface is the
+tested subset described above, and unsupported constructs should fail clearly instead of
+being guessed at.

humemdb-0.1.0.dev2/docs/examples/03_vector_search.md

@@ -0,0 +1,54 @@
+# 03 - Vector Search
+
+[View source code]({{ config.repo_url }}/blob/{{ config.extra.version_tag }}/examples/03_vector_search.py){ .md-button }
+
+This page documents the real repository example `examples/03_vector_search.py`.
+
+## What the Python example does
+
+The script generates a sizable exact-search workload rather than only a handful of
+vectors.
+
+- 24,000 vectors in the `default` collection
+- 12,000 vectors in the `archive` collection
+- 16 dimensions per vector
+- multiple logical buckets
+- exact search through `search_vectors(...)`
+- exact search through raw `query_type="vector"`
+- cache invalidation after inserting additional vectors
+
+## Why this example matters
+
+HumemDB currently positions the public vector runtime as an exact SQLite-plus-NumPy
+baseline. That claim is not very useful if the only shipped example uses three points.
+This example exercises tens of thousands of generated points while staying inside the
+current public `v0` surface.
+
+## Representative flow
+
+```python
+with HumemDB("vectors.sqlite3") as db:
+    db.insert_vectors(build_default_vectors())
+    db.insert_vectors(build_archive_vectors())
+
+    result = db.search_vectors(
+        "default",
+        _embedding(1.0, 0.0, 0.0),
+        top_k=5,
+        metric="cosine",
+    )
+```
+
+## What this means in practice
+
+- SQLite is the canonical vector store.
+- The public path is exact, not ANN.
+- Bucket filters can narrow the candidate set before scoring.
+- Collection caches are invalidated automatically after SQL writes that touch vector
+  storage.
+
+## Metrics
+
+- `cosine`
+- `dot`
+- `l2`

humemdb-0.1.0.dev2/docs/examples/index.md

@@ -0,0 +1,28 @@
+# Examples
+
+HumemDB ships real Python examples in the repository `examples/` directory,
+and the docs pages in this section describe those exact files.
+
+Like the ArcadeDB docs, each page is intended to be a companion to the real Python
+script, not a disconnected hand-written snippet.
+
+Current shipped examples:
+
+- [01 - SQL Basics](01_sql_basics.md): generates 2,000 users and 50,000 orders, then runs both SQLite and DuckDB queries.
+- [02 - Cypher Social Graph](02_cypher_social_graph.md): generates thousands of graph nodes and edges with richer properties.
+- [03 - Vector Search](03_vector_search.md): generates 36,000 vectors across two collections and exercises exact search.
+
+Run them locally from the repository root:
+
+```bash
+uv sync
+uv run python scripts/release/run_examples.py
+```
+
+Or run individual files directly:
+
+```bash
+uv run python examples/01_sql_basics.py
+uv run python examples/02_cypher_social_graph.py
+uv run python examples/03_vector_search.py
+```

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/docs/getting-started/installation.md

@@ -2,7 +2,7 @@
 
 ## Requirements
 
-- Python 3.12 or newer.
+- Python 3.10 or newer.
 - A normal local Python environment managed with `uv`.
 
 ## Install from source
@@ -43,11 +43,19 @@ uv sync --group docs
 
 ## Installed runtime dependencies
 
-- `duckdb`
-- `lancedb`
-- `numpy`
-- `sqlglot[c]`
-- `threadpoolctl`
+- `sqlite3` from the Python standard library for the canonical local write path.
+- `duckdb` for analytical reads.
+- `numpy` for the exact vector search baseline.
+- `sqlglot[c]` for PostgreSQL-like SQL translation.
+- `lancedb` for benchmark work and future indexed ANN paths.
+- `threadpoolctl` for thread-pool coordination.
 
 LanceDB is present for benchmark and later accelerated vector work, but the shipped
-default vector runtime today is still the exact SQLite plus NumPy path.
+default vector runtime today is still the exact SQLite plus NumPy path.
+
+## Licensing note
+
+HumemDB's own code is MIT-licensed, but installed dependencies keep their own licenses.
+See the project [LICENSE]({{ config.repo_url }}/blob/{{ config.extra.version_tag
+}}/LICENSE) for HumemDB itself and the lockfile plus package metadata for the concrete
+third-party dependency set.

{humemdb-0.1.0.dev0 → humemdb-0.1.0.dev2}/docs/index.md

@@ -44,6 +44,6 @@ stays visible.
 
 - [Installation](getting-started/installation.md)
 - [Quick Start](getting-started/quickstart.md)
-- [SQL Example](examples/sql.md)
-- [Cypher Example](examples/cypher.md)
-- [Vector Example](examples/vector.md)
+- [SQL Example](examples/01_sql_basics.md)
+- [Cypher Example](examples/02_cypher_social_graph.md)
+- [Vector Example](examples/03_vector_search.md)