PyPI - getbased-rag - Versions diffs - 0.7.3__tar.gz → 0.7.4__tar.gz - Mend

getbased-rag 0.7.3tar.gz → 0.7.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

{getbased_rag-0.7.3/src/getbased_rag.egg-info → getbased_rag-0.7.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getbased-rag
-Version: 0.7.3
+Version: 0.7.4
 Summary: getbased-rag — standalone RAG knowledge server (formerly the Electron-bundled Lens)
 License-Expression: AGPL-3.0-or-later
 Requires-Python: >=3.10
@@ -14,13 +14,13 @@ Requires-Dist: typer>=0.12
 Requires-Dist: pydantic>=2.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
-Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: python-multipart>=0.0.31
 Provides-Extra: pdf
-Requires-Dist: pypdf>=3.9; extra == "pdf"
+Requires-Dist: pypdf>=6.13.3; extra == "pdf"
 Provides-Extra: docx
 Requires-Dist: python-docx>=1.0; extra == "docx"
 Provides-Extra: full
-Requires-Dist: pypdf>=3.9; extra == "full"
+Requires-Dist: pypdf>=6.13.3; extra == "full"
 Requires-Dist: python-docx>=1.0; extra == "full"
 Requires-Dist: onnxruntime>=1.17; extra == "full"
 Requires-Dist: huggingface-hub>=0.20; extra == "full"
@@ -32,9 +32,9 @@ Dynamic: license-file
 # getbased-rag
-> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP that Claude Code / Hermes / OpenClaw talk to, plus [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard) for a browser UI. One command and you're up.
+> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP adapter and [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard). Use it unless you only want the knowledge server.
-A standalone RAG knowledge server — the backend that used to ship inside the getbased Electron desktop app, now just Python. Point any client (the getbased PWA's *External server* lens backend, the dashboard, or your own) at it.
+A standalone local knowledge server for getbased. Point the getbased PWA's **External server** Knowledge Base backend, the dashboard, or your own compatible client at it.
 - **Stack**: FastAPI + Uvicorn · Qdrant (embedded local mode) · sentence-transformers / ONNX Runtime
 - **Default port**: 8322, loopback only
@@ -69,7 +69,7 @@ lens serve
 First start auto-generates an API key at the data dir (see below), prints the bind address, and lazy-loads the embedding model on the first query (~90 MB download for MiniLM).
-Copy the API key out when you need to configure a client:
+Create the API key file and show its path when you need to configure a client:
 ```bash
 lens key
@@ -78,8 +78,11 @@ lens key
 Smoke test:
 ```bash
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
 curl -s http://127.0.0.1:8322/health
-curl -s -H "Authorization: Bearer $(lens key)" http://127.0.0.1:8322/info | jq
+curl -s -H "Authorization: Bearer ${LENS_API_KEY}" http://127.0.0.1:8322/info | jq
 ```
 Ingest a file or directory from the CLI:
@@ -92,7 +95,10 @@ lens stats
 Or over HTTP (what the dashboard + PWA use):
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -F "files=@paper.pdf" -F "files=@notes.md" \
   http://127.0.0.1:8322/ingest
 ```
@@ -104,7 +110,10 @@ curl -H "Authorization: Bearer $(lens key)" \
 Every library is pinned to one embedding model at creation time — Qdrant collections are dimension-locked, so you can't swap models on an existing library without re-ingesting. Call `GET /models` for the curated list (MiniLM-L6-v2 · BGE-small/base/large-en · BGE-M3) with dims and download sizes, then pass `embedding_model` on create:
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -H "Content-Type: application/json" \
   -d '{"name":"Research","embedding_model":"BAAI/bge-m3"}' \
   http://127.0.0.1:8322/libraries
@@ -127,18 +136,18 @@ The dashboard uses the streaming path for its bottom-right pill (chunks/sec rate
 ## Wiring into the getbased PWA
-In the PWA: **Settings → AI → Knowledge Base → External server**
+In the PWA: open **Knowledge Base**, choose **External server**, then enter:
 | Field | Value |
 |---|---|
 | URL | `http://127.0.0.1:8322` |
-| API key | output of `lens key` |
+| API key | value in the file printed by `lens key` |
 Click **Save**, then **Test connection**. `rag_ready: false` is expected before you ingest anything.
 ### Agent access (Claude Code, Hermes, OpenClaw, etc.)
-Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the lens server and getbased-mcp on the same VM, point MCP's `LENS_URL` at `http://localhost:8322`.
+Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the knowledge server and getbased-mcp on the same machine, then point MCP's `LENS_URL` at `http://localhost:8322`.
 ### Browser UI
@@ -183,7 +192,7 @@ LENS_ONNX_PROVIDER=cuda lens serve
 ## HTTP API
-All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
+All endpoints except `/`, `/health` require `Authorization: Bearer ${LENS_API_KEY}`.
 | Method | Path | Purpose |
 |---|---|---|
@@ -206,7 +215,7 @@ All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
 ## Security notes
 - Default bind is `127.0.0.1` — queries never leak to the LAN unless you explicitly set `LENS_HOST=0.0.0.0`.
-- The API key file is mode `0600` and never exposed over HTTP. Use `lens key` locally to read it.
+- The API key file is mode `0600`; `lens key` shows the file path instead of printing the secret.
 - Bearer comparison uses `secrets.compare_digest` — constant-time, no timing-leak class of bug.
 - Upload paths are basename-sanitised server-side (so `../../etc/passwd` can't escape the ingest temp dir).
 - Zip uploads are zip-slip-guarded — each archive entry must resolve inside its own per-zip subdirectory AND inside the overall ingest root.
@@ -222,8 +231,8 @@ lens ingest <path>    Index files into the active library
 lens stats            List indexed sources + chunk counts
 lens delete <source>  Drop chunks belonging to one source
 lens clear            Wipe the active library
-lens info             Show config + API key
-lens key              Print the API key (creates one if missing)
+lens info             Show config + masked API-key fingerprint
+lens key              Show API key file path
 ```
 ---
@@ -236,4 +245,4 @@ AGPL-3.0-or-later.
 ## Lineage
-This repo is the Python portion lifted out of [getbased](https://github.com/elkimek/getbased) after the Electron desktop app was retired. The PWA's `external-server` lens backend speaks this same HTTP contract unchanged.
+This repo is the Python knowledge-server portion lifted out of [getbased](https://github.com/elkimek/get-based) after the Electron desktop app was retired. The PWA's external-server Knowledge Base backend speaks this same HTTP contract.

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/README.md RENAMED Viewed

@@ -1,8 +1,8 @@
 # getbased-rag
-> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP that Claude Code / Hermes / OpenClaw talk to, plus [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard) for a browser UI. One command and you're up.
+> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP adapter and [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard). Use it unless you only want the knowledge server.
-A standalone RAG knowledge server — the backend that used to ship inside the getbased Electron desktop app, now just Python. Point any client (the getbased PWA's *External server* lens backend, the dashboard, or your own) at it.
+A standalone local knowledge server for getbased. Point the getbased PWA's **External server** Knowledge Base backend, the dashboard, or your own compatible client at it.
 - **Stack**: FastAPI + Uvicorn · Qdrant (embedded local mode) · sentence-transformers / ONNX Runtime
 - **Default port**: 8322, loopback only
@@ -37,7 +37,7 @@ lens serve
 First start auto-generates an API key at the data dir (see below), prints the bind address, and lazy-loads the embedding model on the first query (~90 MB download for MiniLM).
-Copy the API key out when you need to configure a client:
+Create the API key file and show its path when you need to configure a client:
 ```bash
 lens key
@@ -46,8 +46,11 @@ lens key
 Smoke test:
 ```bash
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
 curl -s http://127.0.0.1:8322/health
-curl -s -H "Authorization: Bearer $(lens key)" http://127.0.0.1:8322/info | jq
+curl -s -H "Authorization: Bearer ${LENS_API_KEY}" http://127.0.0.1:8322/info | jq
 ```
 Ingest a file or directory from the CLI:
@@ -60,7 +63,10 @@ lens stats
 Or over HTTP (what the dashboard + PWA use):
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -F "files=@paper.pdf" -F "files=@notes.md" \
   http://127.0.0.1:8322/ingest
 ```
@@ -72,7 +78,10 @@ curl -H "Authorization: Bearer $(lens key)" \
 Every library is pinned to one embedding model at creation time — Qdrant collections are dimension-locked, so you can't swap models on an existing library without re-ingesting. Call `GET /models` for the curated list (MiniLM-L6-v2 · BGE-small/base/large-en · BGE-M3) with dims and download sizes, then pass `embedding_model` on create:
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -H "Content-Type: application/json" \
   -d '{"name":"Research","embedding_model":"BAAI/bge-m3"}' \
   http://127.0.0.1:8322/libraries
@@ -95,18 +104,18 @@ The dashboard uses the streaming path for its bottom-right pill (chunks/sec rate
 ## Wiring into the getbased PWA
-In the PWA: **Settings → AI → Knowledge Base → External server**
+In the PWA: open **Knowledge Base**, choose **External server**, then enter:
 | Field | Value |
 |---|---|
 | URL | `http://127.0.0.1:8322` |
-| API key | output of `lens key` |
+| API key | value in the file printed by `lens key` |
 Click **Save**, then **Test connection**. `rag_ready: false` is expected before you ingest anything.
 ### Agent access (Claude Code, Hermes, OpenClaw, etc.)
-Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the lens server and getbased-mcp on the same VM, point MCP's `LENS_URL` at `http://localhost:8322`.
+Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the knowledge server and getbased-mcp on the same machine, then point MCP's `LENS_URL` at `http://localhost:8322`.
 ### Browser UI
@@ -151,7 +160,7 @@ LENS_ONNX_PROVIDER=cuda lens serve
 ## HTTP API
-All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
+All endpoints except `/`, `/health` require `Authorization: Bearer ${LENS_API_KEY}`.
 | Method | Path | Purpose |
 |---|---|---|
@@ -174,7 +183,7 @@ All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
 ## Security notes
 - Default bind is `127.0.0.1` — queries never leak to the LAN unless you explicitly set `LENS_HOST=0.0.0.0`.
-- The API key file is mode `0600` and never exposed over HTTP. Use `lens key` locally to read it.
+- The API key file is mode `0600`; `lens key` shows the file path instead of printing the secret.
 - Bearer comparison uses `secrets.compare_digest` — constant-time, no timing-leak class of bug.
 - Upload paths are basename-sanitised server-side (so `../../etc/passwd` can't escape the ingest temp dir).
 - Zip uploads are zip-slip-guarded — each archive entry must resolve inside its own per-zip subdirectory AND inside the overall ingest root.
@@ -190,8 +199,8 @@ lens ingest <path>    Index files into the active library
 lens stats            List indexed sources + chunk counts
 lens delete <source>  Drop chunks belonging to one source
 lens clear            Wipe the active library
-lens info             Show config + API key
-lens key              Print the API key (creates one if missing)
+lens info             Show config + masked API-key fingerprint
+lens key              Show API key file path
 ```
 ---
@@ -204,4 +213,4 @@ AGPL-3.0-or-later.
 ## Lineage
-This repo is the Python portion lifted out of [getbased](https://github.com/elkimek/getbased) after the Electron desktop app was retired. The PWA's `external-server` lens backend speaks this same HTTP contract unchanged.
+This repo is the Python knowledge-server portion lifted out of [getbased](https://github.com/elkimek/get-based) after the Electron desktop app was retired. The PWA's external-server Knowledge Base backend speaks this same HTTP contract.

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "getbased-rag"
-version = "0.7.3"
+version = "0.7.4"
 description = "getbased-rag — standalone RAG knowledge server (formerly the Electron-bundled Lens)"
 readme = "README.md"
 license = "AGPL-3.0-or-later"
@@ -18,11 +18,11 @@ dependencies = [
     "pydantic>=2.0",
     "pyyaml>=6.0",
     "rich>=13.0",
-    "python-multipart>=0.0.6",
+    "python-multipart>=0.0.31",
 ]
 [project.optional-dependencies]
-pdf = ["pypdf>=3.9"]
+pdf = ["pypdf>=6.13.3"]
 docx = ["python-docx>=1.0"]
 # ONNX acceleration. `full` now includes it by default — the install
 # is small (~200 MB vs the old ~2 GB) because we load pre-exported
@@ -36,7 +36,7 @@ docx = ["python-docx>=1.0"]
 # already in core gets you the default LocalEmbedder path — ~2-3x
 # slower than ONNX but zero extra config.
 full = [
-    "pypdf>=3.9",
+    "pypdf>=6.13.3",
     "python-docx>=1.0",
     "onnxruntime>=1.17",
     "huggingface-hub>=0.20",

{getbased_rag-0.7.3 → getbased_rag-0.7.4/src/getbased_rag.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getbased-rag
-Version: 0.7.3
+Version: 0.7.4
 Summary: getbased-rag — standalone RAG knowledge server (formerly the Electron-bundled Lens)
 License-Expression: AGPL-3.0-or-later
 Requires-Python: >=3.10
@@ -14,13 +14,13 @@ Requires-Dist: typer>=0.12
 Requires-Dist: pydantic>=2.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
-Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: python-multipart>=0.0.31
 Provides-Extra: pdf
-Requires-Dist: pypdf>=3.9; extra == "pdf"
+Requires-Dist: pypdf>=6.13.3; extra == "pdf"
 Provides-Extra: docx
 Requires-Dist: python-docx>=1.0; extra == "docx"
 Provides-Extra: full
-Requires-Dist: pypdf>=3.9; extra == "full"
+Requires-Dist: pypdf>=6.13.3; extra == "full"
 Requires-Dist: python-docx>=1.0; extra == "full"
 Requires-Dist: onnxruntime>=1.17; extra == "full"
 Requires-Dist: huggingface-hub>=0.20; extra == "full"
@@ -32,9 +32,9 @@ Dynamic: license-file
 # getbased-rag
-> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP that Claude Code / Hermes / OpenClaw talk to, plus [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard) for a browser UI. One command and you're up.
+> **Installing for the first time?** The [getbased-agent-stack](https://github.com/elkimek/getbased-agents/tree/main/packages/stack) meta-package bundles this server with the MCP adapter and [getbased-dashboard](https://github.com/elkimek/getbased-agents/tree/main/packages/dashboard). Use it unless you only want the knowledge server.
-A standalone RAG knowledge server — the backend that used to ship inside the getbased Electron desktop app, now just Python. Point any client (the getbased PWA's *External server* lens backend, the dashboard, or your own) at it.
+A standalone local knowledge server for getbased. Point the getbased PWA's **External server** Knowledge Base backend, the dashboard, or your own compatible client at it.
 - **Stack**: FastAPI + Uvicorn · Qdrant (embedded local mode) · sentence-transformers / ONNX Runtime
 - **Default port**: 8322, loopback only
@@ -69,7 +69,7 @@ lens serve
 First start auto-generates an API key at the data dir (see below), prints the bind address, and lazy-loads the embedding model on the first query (~90 MB download for MiniLM).
-Copy the API key out when you need to configure a client:
+Create the API key file and show its path when you need to configure a client:
 ```bash
 lens key
@@ -78,8 +78,11 @@ lens key
 Smoke test:
 ```bash
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
 curl -s http://127.0.0.1:8322/health
-curl -s -H "Authorization: Bearer $(lens key)" http://127.0.0.1:8322/info | jq
+curl -s -H "Authorization: Bearer ${LENS_API_KEY}" http://127.0.0.1:8322/info | jq
 ```
 Ingest a file or directory from the CLI:
@@ -92,7 +95,10 @@ lens stats
 Or over HTTP (what the dashboard + PWA use):
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -F "files=@paper.pdf" -F "files=@notes.md" \
   http://127.0.0.1:8322/ingest
 ```
@@ -104,7 +110,10 @@ curl -H "Authorization: Bearer $(lens key)" \
 Every library is pinned to one embedding model at creation time — Qdrant collections are dimension-locked, so you can't swap models on an existing library without re-ingesting. Call `GET /models` for the curated list (MiniLM-L6-v2 · BGE-small/base/large-en · BGE-M3) with dims and download sizes, then pass `embedding_model` on create:
 ```bash
-curl -H "Authorization: Bearer $(lens key)" \
+key_file="$(lens key | sed 's/^file: //')"
+LENS_API_KEY="$(tr -d '\n' < "$key_file")"
+curl -H "Authorization: Bearer ${LENS_API_KEY}" \
   -H "Content-Type: application/json" \
   -d '{"name":"Research","embedding_model":"BAAI/bge-m3"}' \
   http://127.0.0.1:8322/libraries
@@ -127,18 +136,18 @@ The dashboard uses the streaming path for its bottom-right pill (chunks/sec rate
 ## Wiring into the getbased PWA
-In the PWA: **Settings → AI → Knowledge Base → External server**
+In the PWA: open **Knowledge Base**, choose **External server**, then enter:
 | Field | Value |
 |---|---|
 | URL | `http://127.0.0.1:8322` |
-| API key | output of `lens key` |
+| API key | value in the file printed by `lens key` |
 Click **Save**, then **Test connection**. `rag_ready: false` is expected before you ingest anything.
 ### Agent access (Claude Code, Hermes, OpenClaw, etc.)
-Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the lens server and getbased-mcp on the same VM, point MCP's `LENS_URL` at `http://localhost:8322`.
+Pair this server with [getbased-mcp](https://github.com/elkimek/getbased-agents/tree/main/packages/mcp) to expose `knowledge_search`, `knowledge_list_libraries`, `knowledge_activate_library`, and `knowledge_stats` as MCP tools. Typical setup: run both the knowledge server and getbased-mcp on the same machine, then point MCP's `LENS_URL` at `http://localhost:8322`.
 ### Browser UI
@@ -183,7 +192,7 @@ LENS_ONNX_PROVIDER=cuda lens serve
 ## HTTP API
-All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
+All endpoints except `/`, `/health` require `Authorization: Bearer ${LENS_API_KEY}`.
 | Method | Path | Purpose |
 |---|---|---|
@@ -206,7 +215,7 @@ All endpoints except `/`, `/health` require `Authorization: Bearer <key>`.
 ## Security notes
 - Default bind is `127.0.0.1` — queries never leak to the LAN unless you explicitly set `LENS_HOST=0.0.0.0`.
-- The API key file is mode `0600` and never exposed over HTTP. Use `lens key` locally to read it.
+- The API key file is mode `0600`; `lens key` shows the file path instead of printing the secret.
 - Bearer comparison uses `secrets.compare_digest` — constant-time, no timing-leak class of bug.
 - Upload paths are basename-sanitised server-side (so `../../etc/passwd` can't escape the ingest temp dir).
 - Zip uploads are zip-slip-guarded — each archive entry must resolve inside its own per-zip subdirectory AND inside the overall ingest root.
@@ -222,8 +231,8 @@ lens ingest <path>    Index files into the active library
 lens stats            List indexed sources + chunk counts
 lens delete <source>  Drop chunks belonging to one source
 lens clear            Wipe the active library
-lens info             Show config + API key
-lens key              Print the API key (creates one if missing)
+lens info             Show config + masked API-key fingerprint
+lens key              Show API key file path
 ```
 ---
@@ -236,4 +245,4 @@ AGPL-3.0-or-later.
 ## Lineage
-This repo is the Python portion lifted out of [getbased](https://github.com/elkimek/getbased) after the Electron desktop app was retired. The PWA's `external-server` lens backend speaks this same HTTP contract unchanged.
+This repo is the Python knowledge-server portion lifted out of [getbased](https://github.com/elkimek/get-based) after the Electron desktop app was retired. The PWA's external-server Knowledge Base backend speaks this same HTTP contract.

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/getbased_rag.egg-info/requires.txt RENAMED Viewed

@@ -6,20 +6,20 @@ typer>=0.12
 pydantic>=2.0
 pyyaml>=6.0
 rich>=13.0
-python-multipart>=0.0.6
+python-multipart>=0.0.31
 [docx]
 python-docx>=1.0
 [full]
-pypdf>=3.9
+pypdf>=6.13.3
 python-docx>=1.0
 onnxruntime>=1.17
 huggingface-hub>=0.20
 tokenizers>=0.15
 [pdf]
-pypdf>=3.9
+pypdf>=6.13.3
 [test]
 pytest>=8.0

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/api_key.py RENAMED Viewed

@@ -9,8 +9,11 @@ from __future__ import annotations
 import os
 import secrets
+import logging
 from pathlib import Path
+log = logging.getLogger("lens.api_key")
 def get_or_create_api_key(key_file: Path) -> str:
     """Read the API key from disk; generate + write one if missing.
@@ -24,8 +27,8 @@ def get_or_create_api_key(key_file: Path) -> str:
             key = key_file.read_text().strip()
             if key:
                 return key
-        except OSError:
-            pass
+        except OSError as e:
+            log.debug("Unable to read existing Lens API key file %s: %s", key_file, e)
     key_file.parent.mkdir(parents=True, exist_ok=True)
     key = secrets.token_urlsafe(32)
@@ -50,6 +53,6 @@ def load_api_key(key_file: Path) -> str | None:
         if key_file.exists():
             key = key_file.read_text().strip()
             return key if key else None
-    except OSError:
-        pass
+    except OSError as e:
+        log.debug("Unable to read Lens API key file %s: %s", key_file, e)
     return None

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/cli.py RENAMED Viewed

@@ -3,7 +3,7 @@
   lens serve            Start the HTTP server (default if no command)
   lens ingest <path>    Index files into the local store
   lens info             Show config + key + status
-  lens key              Print the API key (creates one if missing)
+  lens key              Show API key file path
 Configuration comes from environment variables — see config.py for the full list.
 The Tauri desktop wrapper sets LENS_HOST, LENS_PORT, LENS_DATA_DIR,
@@ -207,9 +207,10 @@ def info():
 @app.command()
 def key():
-    """Print the API key (generates one on first invocation)."""
+    """Show the API key file path, creating the key if missing."""
     config = LensConfig.from_env()
-    print(get_or_create_api_key(config.api_key_file))
+    get_or_create_api_key(config.api_key_file)
+    print(f"file: {config.api_key_file}")
 def main():

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/embedder.py RENAMED Viewed

@@ -50,12 +50,12 @@ class Embedder(ABC):
     @abstractmethod
     def encode(self, texts: list[str]) -> list[list[float]]:
         """Encode a batch of texts into normalized vectors."""
-        ...
+        raise NotImplementedError
     @abstractmethod
     def dimension(self) -> int:
         """Return the embedding dimensionality."""
-        ...
+        raise NotImplementedError
     def info(self) -> dict:
         """Return a small dict describing this backend — which engine,
@@ -237,8 +237,8 @@ class OnnxEmbedder(Embedder):
                     pad_token = raw
                 elif isinstance(raw, dict):
                     pad_token = raw.get("content")
-            except (ValueError, _json.JSONDecodeError):
-                pass
+            except (ValueError, _json.JSONDecodeError) as e:
+                log.debug("Unable to read pad token config from %s: %s", cfg_path, e)
         # Fallback: probe the tokenizer for any of the usual suspects.
         if not pad_token:
@@ -435,8 +435,8 @@ class OnnxEmbedder(Embedder):
                 # cap"; treat anything absurd as 512 fallback.
                 if 32 <= ml <= 16384:
                     return ml
-            except (ValueError, _json.JSONDecodeError):
-                pass
+            except (ValueError, _json.JSONDecodeError) as e:
+                log.debug("Unable to read max-length config from %s: %s", cfg, e)
         return 8192 if "bge-m3" in self._model_name.lower() else 512
     def _detect_dimension(self) -> int:
@@ -506,8 +506,8 @@ class OnnxEmbedder(Embedder):
                 providers = self._session.get_providers()
                 if providers:
                     active = providers[0]
-            except Exception:
-                pass
+            except Exception as e:  # noqa: BLE001
+                log.debug("Unable to inspect active ONNX providers: %s", e)
         return {
             "engine": "onnx",
             "model": self._model_name,
@@ -577,8 +577,8 @@ class LocalEmbedder(Embedder):
                 device = "cuda"
             elif hasattr(torch.backends, "mps") and torch.backends.mps.is_available():
                 device = "mps"
-        except Exception:
-            pass
+        except Exception as e:  # noqa: BLE001
+            log.debug("Unable to inspect torch device availability: %s", e)
         return {
             "engine": "pytorch",
             "model": self._model_name,
@@ -638,8 +638,8 @@ class CloudInferenceEmbedder(Embedder):
         host = ""
         try:
             host = urlparse(self._url).hostname or ""
-        except Exception:
-            pass
+        except Exception as e:  # noqa: BLE001
+            log.debug("Unable to parse Qdrant Cloud host from %s: %s", self._url, e)
         return {
             "engine": "qdrant-cloud",
             "model": self._model_name,

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/registry.py RENAMED Viewed

@@ -23,8 +23,6 @@ import os
 import tempfile
 import time
 import uuid
-from pathlib import Path
-from typing import Optional
 from .config import LensConfig
@@ -90,14 +88,14 @@ class Registry:
                 f.flush()
                 try:
                     os.fsync(f.fileno())
-                except OSError:
-                    pass
+                except OSError as e:
+                    log.debug("Unable to fsync libraries registry temp file: %s", e)
             os.replace(tmp_name, self._path)
         except Exception:
             try:
                 os.unlink(tmp_name)
-            except OSError:
-                pass
+            except OSError as e:
+                log.debug("Unable to remove temporary libraries registry %s: %s", tmp_name, e)
             raise
     # ── Public surface ────────────────────────────────────────────────

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/server.py RENAMED Viewed

@@ -74,6 +74,10 @@ class LibraryRenameRequest(BaseModel):
     name: str = Field(..., min_length=1, max_length=120)
+class SourceDeleteRequest(BaseModel):
+    source: str = Field(..., min_length=1, max_length=4096)
 def create_app(config: LensConfig) -> FastAPI:
     """Build the FastAPI app with config-driven dependencies."""
     config.ensure_dirs()
@@ -282,13 +286,8 @@ def create_app(config: LensConfig) -> FastAPI:
             log.exception("Stats failed")
             raise HTTPException(500, "Stats failed — see server logs")
-    @app.delete("/sources/{source:path}")
-    async def delete_source_endpoint(
-        source: str,
-        authorization: Optional[str] = Header(default=None),
-    ):
+    def _delete_source(source: str) -> dict:
         """Delete every chunk for a given source in the active library."""
-        require_auth(authorization)
         store = active_store()
         try:
             deleted = store.delete_by_source(source)
@@ -297,6 +296,27 @@ def create_app(config: LensConfig) -> FastAPI:
             log.exception("Delete failed")
             raise HTTPException(500, "Delete failed — see server logs")
+    @app.post("/sources/delete")
+    async def delete_source_body_endpoint(
+        req: SourceDeleteRequest,
+        authorization: Optional[str] = Header(default=None),
+    ):
+        """Delete a source via a fixed upstream path and JSON body.
+        Dashboard uses this route so browser-provided source names never become
+        part of the dashboard→rag request URL.
+        """
+        require_auth(authorization)
+        return _delete_source(req.source)
+    @app.delete("/sources/{source:path}")
+    async def delete_source_endpoint(
+        source: str,
+        authorization: Optional[str] = Header(default=None),
+    ):
+        require_auth(authorization)
+        return _delete_source(source)
     @app.delete("/sources")
     async def clear_endpoint(authorization: Optional[str] = Header(default=None)):
         """Drop the active library's collection contents."""
@@ -668,7 +688,7 @@ def create_app(config: LensConfig) -> FastAPI:
                             break
                         await _asyncio.sleep(1.0)
                 except _asyncio.CancelledError:
-                    pass
+                    log.debug("Disconnect watcher cancelled")
             async def _ndjson_gen():
                 ingest_task = _asyncio.create_task(_run_ingest())
@@ -688,8 +708,12 @@ def create_app(config: LensConfig) -> FastAPI:
                     if not ingest_task.done():
                         try:
                             await _asyncio.wait_for(ingest_task, timeout=5.0)
-                        except (_asyncio.CancelledError, _asyncio.TimeoutError, Exception):
-                            pass
+                        except _asyncio.CancelledError:
+                            log.debug("Cancelled while waiting for ingest task cleanup")
+                        except _asyncio.TimeoutError:
+                            log.debug("Timed out waiting for ingest task cleanup")
+                        except Exception as e:  # noqa: BLE001
+                            log.debug("Ingest task cleanup failed: %s", e)
                     _cleanup_tmpdir()
             return StreamingResponse(

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/src/lens/store.py RENAMED Viewed

@@ -3,7 +3,6 @@
 from __future__ import annotations
 import logging
-from pathlib import Path
 from typing import Optional
 from .config import LensConfig

{getbased_rag-0.7.3 → getbased_rag-0.7.4}/tests/test_onnx_embedder.py RENAMED Viewed

@@ -10,10 +10,8 @@ these silently corrupts embeddings for someone's knowledge base.
 from __future__ import annotations
 import json
-import os
 from pathlib import Path
-import numpy as np
 import pytest
 from lens.embedder import OnnxEmbedder, _ONNX_REPO_MAP