patchvec 0.5.6__tar.gz

patchvec-0.5.6/ABOUT.md

@@ -0,0 +1,69 @@
+# PatchVec — A lightweight, pluggable vector search microservice.
+
+Upload → chunk → index (with metadata) → search via REST and CLI.
+
+## Highlights
+- Multi-tenant collections: `/collections/{tenant}/{name}`
+- Upload and search **TXT**, **CSV**, and **PDF**
+- Chunking per format:
+  - PDF → 1 chunk/page
+  - TXT → configurable chunk size + overlap
+  - CSV → 1 chunk/row
+- Metadata filters on POST search (`{"filters": {"docid": "DOC-1"}}`)
+- Health, metrics, and Prometheus endpoints
+- Configurable auth modes: `none` or `static` (Bearer)
+- Default backends are local (vendor-neutral "default"); embedders & stores are pluggable
+
+## Requirements
+- Python 3.10+
+
+## Install
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install patchvec
+```
+
+> CPU-only by default. If you have a CUDA setup and want GPU-accelerated deps, install the GPU-enabled packages in your environment before running PatchVec.
+
+## Quickstart
+```bash
+# Start the server (installed entry point)
+pavesrv
+
+# Or run with uvicorn manually if you prefer:
+uvicorn pave.main:app --host 0.0.0.0 --port 8080
+```
+
+## Minimal config (optional)
+By default PatchVec runs with sensible local defaults. To customize, create `config.yml` and set:
+```yaml
+vector_store:
+  type: default
+embedder:
+  type: default
+auth:
+  mode: none    # or 'static' with per-tenant Bearer keys
+```
+Then export:
+```bash
+export PATCHVEC_CONFIG=./config.yml
+```
+
+## REST example
+```bash
+# Create a collection
+curl -X POST http://localhost:8080/collections/acme/docs
+
+# Upload a TXT document
+curl -X POST http://localhost:8080/collections/acme/docs/documents   -F "file=@sample.txt" -F "docid=DOC1"
+
+# Search (GET, no filters)
+curl -G --data-urlencode "q=hello" http://localhost:8080/collections/acme/docs/search
+
+# Search (POST, with filters)
+curl -X POST http://localhost:8080/collections/acme/docs/search   -H "Content-Type: application/json"   -d '{"q":"hello","k":5,"filters":{"docid":"DOC1"}}'
+```
+
+## License
+GPL-3.0-or-later — (C) 2025 Rodrigo Rodrigues da Silva

patchvec-0.5.6/LICENSE

@@ -0,0 +1,9 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2025 Rodrigo Rodrigues da Silva <rodrigopitanga@posteo.net>
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+Full text: https://www.gnu.org/licenses/gpl-3.0.txt

patchvec-0.5.6/MANIFEST.in

@@ -0,0 +1,12 @@
+include ABOUT.md
+include README.md
+include LICENSE
+include config.yml.example
+include requirements.txt
+include requirements-cpu.txt
+include requirements-base.txt
+include requirements-test.txt
+recursive-include pave *.py
+recursive-include scripts *.sh
+recursive-include pave/assets *
+global-exclude __pycache__ *.py[cod] *.so

patchvec-0.5.6/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: patchvec
+Version: 0.5.6
+Summary: Patchvec — A lightweight, pluggable vector search microservice.
+Author: Rodrigo Rodrigues da Silva
+Author-email: rodrigopitanga@posteo.net
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://gitlab.com/flowlexi/patchvec
+Project-URL: Source, https://gitlab.com/flowlexi/patchvec
+Project-URL: Tracker, https://gitlab.com/flowlexi/patchvec/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+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: Framework :: FastAPI
+Classifier: Topic :: Database
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.30.6
+Requires-Dist: txtai>=6.3.0
+Requires-Dist: pydantic>=2.8.2
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pypdf>=5.0.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: qdrant-client>=1.9.2
+Requires-Dist: sentence-transformers>=2.7.0
+Requires-Dist: openai>=1.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PatchVec — A lightweight, pluggable vector search microservice.
+
+Upload → chunk → index (with metadata) → search via REST and CLI.
+
+## Highlights
+- Multi-tenant collections: `/collections/{tenant}/{name}`
+- Upload and search **TXT**, **CSV**, and **PDF**
+- Chunking per format:
+  - PDF → 1 chunk/page
+  - TXT → configurable chunk size + overlap
+  - CSV → 1 chunk/row
+- Metadata filters on POST search (`{"filters": {"docid": "DOC-1"}}`)
+- Health, metrics, and Prometheus endpoints
+- Configurable auth modes: `none` or `static` (Bearer)
+- Default backends are local (vendor-neutral "default"); embedders & stores are pluggable
+
+## Requirements
+- Python 3.10+
+
+## Install
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install patchvec
+```
+
+> CPU-only by default. If you have a CUDA setup and want GPU-accelerated deps, install the GPU-enabled packages in your environment before running PatchVec.
+
+## Quickstart
+```bash
+# Start the server (installed entry point)
+pavesrv
+
+# Or run with uvicorn manually if you prefer:
+uvicorn pave.main:app --host 0.0.0.0 --port 8080
+```
+
+## Minimal config (optional)
+By default PatchVec runs with sensible local defaults. To customize, create `config.yml` and set:
+```yaml
+vector_store:
+  type: default
+embedder:
+  type: default
+auth:
+  mode: none    # or 'static' with per-tenant Bearer keys
+```
+Then export:
+```bash
+export PATCHVEC_CONFIG=./config.yml
+```
+
+## REST example
+```bash
+# Create a collection
+curl -X POST http://localhost:8080/collections/acme/docs
+
+# Upload a TXT document
+curl -X POST http://localhost:8080/collections/acme/docs/documents   -F "file=@sample.txt" -F "docid=DOC1"
+
+# Search (GET, no filters)
+curl -G --data-urlencode "q=hello" http://localhost:8080/collections/acme/docs/search
+
+# Search (POST, with filters)
+curl -X POST http://localhost:8080/collections/acme/docs/search   -H "Content-Type: application/json"   -d '{"q":"hello","k":5,"filters":{"docid":"DOC1"}}'
+```
+
+## License
+GPL-3.0-or-later — (C) 2025 Rodrigo Rodrigues da Silva

patchvec-0.5.6/README.md

@@ -0,0 +1,87 @@
+# 🍰 PatchVec — Lightweight, Pluggable Vector Search Microservice
+
+Upload → chunk → index (with metadata) → search via REST and CLI.
+
+---
+
+## 🚀 Quickstart
+
+### 🖥️ CPU-only Dev (default)
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+pip install -r requirements-cpu.txt
+./pavesrv.sh
+```
+
+### 📦 Install from PyPI
+```bash
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+pip install patchvec[cpu]   # or patchvec[gpu] for CUDA
+```
+
+### ▶️ Run the Server
+From source:
+```bash
+./pavesrv.sh
+```
+From PyPI:
+```bash
+pavesrv
+```
+
+### ⚙️ Minimal Config
+For production (static auth), set env vars (do not commit secrets):
+```env
+PATCHVEC_AUTH__MODE=static
+PATCHVEC_AUTH__GLOBAL_KEY=sekret-passwod
+```
+(Optional: copy `config.yml.example` to an untracked `config.yml` and tweak as needed)
+(Tip: use an untracked `tenants.yml` and point `auth.tenants_file` to it in `config.yml`.)
+
+---
+
+## 🔧 Overriding Server Settings (uvicorn)
+You can override a few server knobs via environment variables:
+```bash
+HOST=127.0.0.1 PORT=9000 RELOAD=1 WORKERS=4 LOG_LEVEL=debug pavesrv
+```
+> Note: Full configuration uses the `PATCHVEC_...` env scheme (e.g., `PATCHVEC_SERVER__PORT=9000`).
+
+---
+
+## 🌐 REST API Examples
+
+**Create a collection**
+```bash
+curl -X POST "http://localhost:8086/collections/acme/invoices"
+```
+
+**Upload a TXT/PDF/CSV document**
+```bash
+curl -X POST "http://localhost:8086/collections/acme/invoices/documents"   -F "file=@sample.txt"   -F "docid=DOC-1"   -F 'metadata={"lang":"pt"}'
+```
+
+**Search (GET, no filters)**
+```bash
+curl "http://localhost:8086/collections/acme/invoices/search?q=garantia&k=5"
+```
+
+**Search (POST with filters)**
+```bash
+curl -X POST "http://localhost:8086/collections/acme/invoices/search"   -H "Content-Type: application/json"   -d '{"q": "garantia", "k": 5, "filters": {"docid": "DOC-1"}}'
+```
+
+**Health / Metrics**
+```bash
+curl "http://localhost:8086/health"
+curl "http://localhost:8086/metrics"
+```
+
+---
+
+## 📜 License
+GPL-3.0-or-later — (C) 2025 Rodrigo Rodrigues da Silva

patchvec-0.5.6/config.yml.example

@@ -0,0 +1,69 @@
+# Patchvec sample configuration (commit this file as config.yml.example)
+# Copy to config.yml and adjust. Secrets should live in a separate, untracked file (see tenants.yml.example).
+
+data_dir: ./data
+
+# Optional "common" collection included in searches when enabled
+common_enabled: true
+common_tenant: global
+common_collection: common
+
+# Authentication
+auth:
+  # Modes: none | static
+  mode: static
+  # Default admin user when auth=none
+  default_access_tenant: public
+  # Global admin key (read from env; forced NOT hardcode in committed files)
+  global_key: ${PATCHVEC_GLOBAL_KEY}
+  # External tenants→keys mapping file (untracked). If present, it
+  # will be merged and override duplicates.
+  tenants_file: ./tenants.yml
+  # Inline mapping (fallback; keep empty in repo)
+  api_keys: {}
+
+# Vector store selection
+vector_store:
+  type: default           # default | qdrant
+  txtai:
+    embed_model: sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2
+    backend: faiss
+  qdrant:
+    url: http://localhost:6333
+    api_key: ${PATCHVEC_QDRANT_API_KEY}
+    prefer_payload_filters: true
+    collection_prefix: patchvec_
+
+# Embedder selection
+embedder:
+  type: default           # default | sbert | openai
+  # default (txtai-backed)
+  txtai:
+    path: sentence-transformers/paraphrase-MiniLM-L3-v2
+  sbert:
+    model: sentence-transformers/all-MiniLM-L6-v2
+    batch_size: 64
+    device: auto            # cpu | cuda | auto
+  openai:
+    api_key: ${PATCHVEC_OPENAI_API_KEY}
+    dim: 1536
+
+# Text preprocessing
+preprocess:
+  txt_chunk_size: 1000
+  txt_chunk_overlap: 200
+
+# Optional server defaults
+# (env HOST/PORT/RELOAD/WORKERS/LOG_LEVEL always override)
+server:
+  host: 0.0.0.0
+  port: 8086
+  reload: false
+  workers: 1
+  log_level: info
+
+# Optional instance customization
+instance:
+  name: PatchVec
+  desc: Vector Search Microservice (pluggable, functional)
+

patchvec-0.5.6/patchvec.egg-info/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: patchvec
+Version: 0.5.6
+Summary: Patchvec — A lightweight, pluggable vector search microservice.
+Author: Rodrigo Rodrigues da Silva
+Author-email: rodrigopitanga@posteo.net
+License: GPL-3.0-or-later
+Project-URL: Homepage, https://gitlab.com/flowlexi/patchvec
+Project-URL: Source, https://gitlab.com/flowlexi/patchvec
+Project-URL: Tracker, https://gitlab.com/flowlexi/patchvec/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+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: Framework :: FastAPI
+Classifier: Topic :: Database
+Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.30.6
+Requires-Dist: txtai>=6.3.0
+Requires-Dist: pydantic>=2.8.2
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pypdf>=5.0.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: qdrant-client>=1.9.2
+Requires-Dist: sentence-transformers>=2.7.0
+Requires-Dist: openai>=1.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PatchVec — A lightweight, pluggable vector search microservice.
+
+Upload → chunk → index (with metadata) → search via REST and CLI.
+
+## Highlights
+- Multi-tenant collections: `/collections/{tenant}/{name}`
+- Upload and search **TXT**, **CSV**, and **PDF**
+- Chunking per format:
+  - PDF → 1 chunk/page
+  - TXT → configurable chunk size + overlap
+  - CSV → 1 chunk/row
+- Metadata filters on POST search (`{"filters": {"docid": "DOC-1"}}`)
+- Health, metrics, and Prometheus endpoints
+- Configurable auth modes: `none` or `static` (Bearer)
+- Default backends are local (vendor-neutral "default"); embedders & stores are pluggable
+
+## Requirements
+- Python 3.10+
+
+## Install
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install patchvec
+```
+
+> CPU-only by default. If you have a CUDA setup and want GPU-accelerated deps, install the GPU-enabled packages in your environment before running PatchVec.
+
+## Quickstart
+```bash
+# Start the server (installed entry point)
+pavesrv
+
+# Or run with uvicorn manually if you prefer:
+uvicorn pave.main:app --host 0.0.0.0 --port 8080
+```
+
+## Minimal config (optional)
+By default PatchVec runs with sensible local defaults. To customize, create `config.yml` and set:
+```yaml
+vector_store:
+  type: default
+embedder:
+  type: default
+auth:
+  mode: none    # or 'static' with per-tenant Bearer keys
+```
+Then export:
+```bash
+export PATCHVEC_CONFIG=./config.yml
+```
+
+## REST example
+```bash
+# Create a collection
+curl -X POST http://localhost:8080/collections/acme/docs
+
+# Upload a TXT document
+curl -X POST http://localhost:8080/collections/acme/docs/documents   -F "file=@sample.txt" -F "docid=DOC1"
+
+# Search (GET, no filters)
+curl -G --data-urlencode "q=hello" http://localhost:8080/collections/acme/docs/search
+
+# Search (POST, with filters)
+curl -X POST http://localhost:8080/collections/acme/docs/search   -H "Content-Type: application/json"   -d '{"q":"hello","k":5,"filters":{"docid":"DOC1"}}'
+```
+
+## License
+GPL-3.0-or-later — (C) 2025 Rodrigo Rodrigues da Silva

patchvec-0.5.6/patchvec.egg-info/SOURCES.txt

@@ -0,0 +1,54 @@
+ABOUT.md
+LICENSE
+MANIFEST.in
+README.md
+config.yml.example
+requirements-base.txt
+requirements-cpu.txt
+requirements-test.txt
+requirements.txt
+setup.py
+patchvec.egg-info/PKG-INFO
+patchvec.egg-info/SOURCES.txt
+patchvec.egg-info/dependency_links.txt
+patchvec.egg-info/entry_points.txt
+patchvec.egg-info/requires.txt
+patchvec.egg-info/top_level.txt
+pave/__init__.py
+pave/auth.py
+pave/cli.py
+pave/config.py
+pave/main.py
+pave/metrics.py
+pave/preprocess.py
+pave/service.py
+pave/ui.py
+pave/assets/patchvec_icon_192.png
+pave/assets/ui.html
+pave/embedders/__init__.py
+pave/embedders/base.py
+pave/embedders/factory.py
+pave/embedders/openai_emb.py
+pave/embedders/sbert_emb.py
+pave/embedders/txtai_emb.py
+pave/stores/__init__.py
+pave/stores/base.py
+pave/stores/factory.py
+pave/stores/qdrant_store.py
+pave/stores/txtai_store.py
+scripts/release.sh
+tests/test_auth.py
+tests/test_cli.py
+tests/test_collections.py
+tests/test_config_runtime.py
+tests/test_csv_ingest.py
+tests/test_docid_default.py
+tests/test_health.py
+tests/test_metrics.py
+tests/test_txtai_concurrent_upsert.py
+tests/test_txtai_store.py
+tests/test_txtai_store_filters.py
+tests/test_ui.py
+tests/test_upload_search_csv.py
+tests/test_upload_search_pdf.py
+tests/test_upload_search_txt.py

patchvec-0.5.6/patchvec.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

patchvec-0.5.6/patchvec.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pavecli = pave.cli:main_cli
+pavesrv = pave.main:main_srv

patchvec-0.5.6/patchvec.egg-info/requires.txt

@@ -0,0 +1,11 @@
+fastapi>=0.115.0
+uvicorn[standard]>=0.30.6
+txtai>=6.3.0
+pydantic>=2.8.2
+python-multipart>=0.0.9
+pypdf>=5.0.0
+pyyaml>=6.0.2
+python-dotenv>=1.0.1
+qdrant-client>=1.9.2
+sentence-transformers>=2.7.0
+openai>=1.0.0

patchvec-0.5.6/patchvec.egg-info/top_level.txt

@@ -0,0 +1 @@
+pave

patchvec-0.5.6/pave/__init__.py

@@ -0,0 +1,6 @@
+# (C) 2025 Rodrigo Rodrigues da Silva <rodrigopitanga@posteo.net>
+# SPDX-License-Identifier: GPL-3.0-or-later
+__all__ = [
+    "config", "auth", "preprocess", "metrics", "service", "main", "cli",
+    "embedders", "stores"
+]

patchvec-0.5.6/pave/assets/ui.html

@@ -0,0 +1,125 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width,initial-scale=1" />
+<!-- favicon robusto -->
+<link rel="icon" type="image/png" sizes="32x32" href="/assets/patchvec_icon_192.png" />
+<link rel="icon" type="image/png" sizes="192x192" href="/assets/patchvec_icon_192.png" />
+<link rel="icon" href="/favicon.ico" />
+<title>__INST_NAME__ • Search</title>
+<style>
+  /* paleta */
+  :root{ --bg:#f6e6d9; --panel:#fffaf6; --text:#2b1e11; --muted:#6b5b53; --accent:#c9463d; --border:#ead7c7; --link:#0f2e4d; --link-accent:#14b8a6; }
+  @media (prefers-color-scheme: dark){
+    :root{ --bg:#1a1410; --panel:#221a14; --text:#f1e9e4; --muted:#b7a9a1; --accent:#ef6b62; --border:#3a2c22; --link:#9dd9d3; --link-accent:#34d399; }
+  }
+
+  *{ box-sizing:border-box }
+  html,body{ height:100% }
+  body{
+    min-height:100vh; display:flex; flex-direction:column; overflow:hidden;
+    margin:0; font:16px/1.45 system-ui,Segoe UI,Roboto,Inter,Arial; background:var(--bg); color:var(--text);
+  }
+
+  .bar{
+    flex:0 0 auto; display:flex; gap:10px; align-items:center;
+    padding:12px; border-bottom:1px solid var(--border); background:var(--panel);
+  }
+  .left{ display:flex; gap:8px; align-items:center }
+  .right{ margin-left:auto; color:var(--muted); white-space:nowrap; overflow:hidden; text-overflow:ellipsis }
+
+  .tab{
+    padding:8px 12px; border-radius:10px; border:1px solid var(--border);
+    cursor:pointer; background:transparent; color:var(--text);
+  }
+  .tab.active{ background:var(--link-accent); color:#041318; border-color:var(--link-accent) }
+
+  .frames{ flex:1 1 auto; min-height:0; background:var(--bg) }
+  .frame{ display:none; width:100%; height:100%; border:0; background:var(--bg) }
+  .frame.active{ display:block }
+
+  .footer{
+    flex:0 0 auto; position:sticky; bottom:0;
+    display:flex; gap:12px; align-items:center; justify-content:center;
+    padding:10px; color:var(--muted); border-top:1px solid var(--border); background:var(--panel);
+  }
+  .footer a{ color:var(--link); text-decoration:none }
+  .footer a:hover{ color:var(--link-accent) }
+</style>
+</head>
+<body>
+  <div class="bar">
+    <div class="left">
+      <button class="tab active" data-target="search" data-title="__INST_NAME__ • Search">Search</button>
+      <button class="tab" data-target="ingest" data-title="__INST_NAME__ • Ingest">Ingest</button>
+    </div>
+    <div class="right"><strong>__INST_NAME__</strong> — <small>__INST_DESC__</small></div>
+  </div>
+
+  <div class="frames">
+    <iframe id="search" class="frame active" src="/ui/search" title="Search"></iframe>
+    <iframe id="ingest" class="frame" src="/ui/ingest" title="Ingest"></iframe>
+  </div>
+
+  <div class="footer">
+    © 2025 <a href="https://flowlexi.com" target="_blank" rel="noopener">Flowlexi</a> •
+    <a href="__REPO_URL__" target="_blank" rel="noopener">🍰 patchvec __VERSION__</a> •
+    <a href="__LICENSE_URL__" target="_blank" rel="noopener">__LICENSE_NAME__</a>
+  </div>
+<script>
+  function activeFrame(){ return document.querySelector('.frame.active'); }
+
+  function scrubSwagger(frame){
+    const win = frame?.contentWindow;
+    const doc = win?.document;
+    if(!doc) return;
+    if(!doc.querySelector('.swagger-ui')){
+      setTimeout(()=>scrubSwagger(frame), 80);
+      return;
+    }
+
+    // CSS: remove topo/infos
+    const STYLE_ID = 'pv-clean';
+    if(!doc.getElementById(STYLE_ID)){
+      const s = doc.createElement('style');
+      s.id = STYLE_ID;
+      s.textContent = `
+        #operations-tag-default,
+        .swagger-ui .topbar,
+        .swagger-ui .download-url-wrapper,
+        .swagger-ui .information-container,
+        .swagger-ui .info,
+        .swagger-ui .servers { display:none !important; }
+        .swagger-ui .wrapper { margin:0 !important; padding:0 0 8px !important; }
+        html, body { background:transparent !important; }
+        /* auth icon */
+        .swagger-ui .auth-wrapper .authorize:hover { border-color: rgba(20,184,166,.8); }
+        .swagger-ui .btn.authorize { background: white }
+        .swagger-ui .scheme-container { width:100%; height:; margin: 8px 0 0 0; padding: 0 0; background:transparent; border-color: transparent; box-shadow:0 0 0 0 rgba(0,0,0,0)}
+      `;
+      doc.head.appendChild(s);
+    }
+  }
+
+  const tabs = document.querySelectorAll('.tab');
+  const frames = document.querySelectorAll('.frame');
+
+  tabs.forEach(function(tab){
+    tab.addEventListener('click', function(){
+      tabs.forEach(t=>t.classList.remove('active'));
+      frames.forEach(f=>f.classList.remove('active'));
+      tab.classList.add('active');
+      const fr = document.getElementById(tab.dataset.target);
+      fr.classList.add('active');
+      document.title = tab.dataset.title || document.title;
+      scrubSwagger(fr);
+    });
+  });
+
+  frames.forEach(function(fr){
+      fr.addEventListener('load', function(){ scrubSwagger(fr); });
+  });
+</script>
+</body>
+</html>