garage-rag 1.5.0__tar.gz

garage_rag-1.5.0/.gitignore

@@ -0,0 +1,36 @@
+*.pyc
+.venv
+.env
+*.db
+.build
+macapp/build/
+# Credential files (an LM Studio token, or a key left over from the retired cloud OCR)
+*.key
+anthropic.key
+
+# Per-project config override (holds absolute paths and identity)
+garage.json
+
+*.bak-*
+
+__pycache__
+
+bazel-*
+
+.bazelbsp/
+*.xcodeproj
+.output.txt
+build/
+# IDE data-source definitions embed the local database password
+.idea/dataSources.xml
+.idea/dataSources.local.xml
+
+# Local Bazel overrides (see .bazelrc)
+user.bazelrc
+
+.ruff_cache/
+.mypy_cache/
+garage_python/dist/
+
+# Release archives staged by //macapp/package:publish_appcast
+/dist/

garage_rag-1.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rick Mark-Penwell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

garage_rag-1.5.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.5
+Name: garage_rag
+Version: 1.5.0
+Summary: Local-first personal RAG pipeline over Postgres + pgvector, with authorship attribution and an MCP server
+Project-URL: Homepage, https://garagerag.app
+Project-URL: Source, https://github.com/rickmark/garage-rag
+Project-URL: Issues, https://github.com/rickmark/garage-rag/issues
+Author: Rick Mark-Penwell
+License: MIT License
+        
+        Copyright (c) 2026 Rick Mark-Penwell
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: embeddings,mcp,pgvector,postgres,rag,search
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: <3.15,>=3.13
+Requires-Dist: certifi>=2024.2.2
+Requires-Dist: cryptography>=44
+Requires-Dist: grpcio>=1.68.0
+Requires-Dist: httpx>=0.28
+Requires-Dist: mcp[cli]==2.1.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pdfplumber>=0.11.10
+Requires-Dist: pgvector<0.6,>=0.5
+Requires-Dist: pillow>=11.0
+Requires-Dist: protobuf>=5.29.0
+Requires-Dist: psycopg[pool]>=3.2
+Requires-Dist: pydantic>=2.7.4
+Requires-Dist: pypdf>=6.16
+Requires-Dist: pytest>=9.1.1
+Requires-Dist: python-docx>=1.2
+Requires-Dist: python-pptx>=1.0.2
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: regex>=2023.0.0
+Requires-Dist: rich>=13.9
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: truststore>=0.10
+Requires-Dist: typer>=0.15
+Requires-Dist: uvicorn>=0.30
+Provides-Extra: build-tools
+Requires-Dist: build; extra == 'build-tools'
+Requires-Dist: setuptools; extra == 'build-tools'
+Provides-Extra: dev
+Requires-Dist: faker>=37; extra == 'dev'
+Requires-Dist: grpcio-tools>=1.68.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: tree-sitter-swift>=0.7; extra == 'dev'
+Requires-Dist: tree-sitter>=0.25; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# garage_rag
+
+The Python half of [Garage](https://github.com/rickmark/garage-rag#readme): a local-first personal RAG pipeline over
+PostgreSQL + pgvector. It walks personal documents, code repositories and communications,
+extracts and chunks their text, attributes authorship, embeds every chunk under each
+registered model, distills documents into span-grounded facts, and serves the corpus over
+MCP 2.0 and gRPC. Garage never sends communications off the machine (MCP clients you connect still receive what they retrieve); see [`docs/privacy.md`](https://github.com/rickmark/garage-rag/blob/main/docs/privacy.md).
+
+## Entry points
+
+| Command | Module | Role |
+|---|---|---|
+| `garage` | `garage_rag.cli:main_cli` | ingest, backfill, enrich-facts, search, config, model registry, `serve` (gRPC bridge for the macOS app) |
+| `garage-mcp` | `garage_rag.mcp_server.server:main` | MCP 2.0 server over stdio, the command MCP clients spawn (`garage mcp-install --stdio` wires it into Claude Desktop/Code); `garage mcp-serve` runs the HTTP server |
+
+Both are console scripts of the `garage_rag` package. The macOS app does not
+ship them as standalone binaries: it bundles the package as
+`site-python` inside `Frameworks/PythonXPCService.framework` (`//garage_python:site-packages`) and runs it through
+Swift launchers that embed the bundled interpreter, packaged as helper bundles
+(`Contents/Helpers/garage.app` and `garage-mcp.app`, `//macapp/Sources/GarageCLI:garage_app` and
+`//macapp/Sources/GarageMCPCLI:garage_mcp_app`) and reached through the stable paths
+`Contents/MacOS/garage` and `garage-mcp`. Those launchers find or start the app's database and
+export `GARAGE_DATABASE_URL`; the console scripts from a venv do not.
+
+## Layout
+
+```
+src/garage_rag/
+  ingest/     walker, materialization budget, chunking, scanner, pipeline, Messages threads,
+              the storage gateway (in-process SQLAlchemy, or gRPC for the XPC workers)
+  extract/    per-format extractors (text, PDF, Office, images via in-process Tesseract, mail) + quality gate
+  attribute/  git / metadata / path-rule / message-sender authorship signals
+  embed/      embedding backends (Ollama, LM Studio, llama XPC) and backfill
+  enrich/     fact distillation (vendored local LangExtract subset) and local generation
+  inference/  the one HTTP client for LM Studio, Ollama and the app's LlamaXPCService
+  net/        egress.py, the only module that opens outbound connections
+  search/     hybrid RRF search
+  mcp_server/ MCP tools and client registration (mcp-install)
+  service/    gRPC GarageService (proto/garage.proto) and its client
+  ops/        the operations the CLI and the gRPC handlers both present
+  xpc/        hooks for the app's XPC hosts (llama_xpc client, model loader)
+  native/     finds libpq / libtesseract already loaded into the process
+  db/         SQLAlchemy models mirroring data/sql/00*.sql, migrations, model registry
+  config/     garage.json settings and the generated JSON Schema
+tests/        pytest suite, one Bazel py_test target per file
+```
+
+## Building and testing
+
+Everything is driven by the Aspect CLI from the repository root:
+
+```bash
+aspect build //garage_python:site-packages
+aspect test //garage_python/tests:suite
+aspect test //garage_python/tests:test_facts --bazel-flag=--test_arg=-k --bazel-flag=--test_arg=some_case
+```
+
+`tests/BUILD.bazel` has one `py_test` per file (via `//tools/pytest:defs.bzl`, which drives
+pytest); `aspect gazelle` writes the target for a new test file, and the `suite` list is kept by
+hand. Third-party
+dependencies live in `pyproject.toml` and are locked with `uv` (`../tools/repin`), exposed to
+Bazel as `@pypi//<package>`.
+
+For quick iteration outside Bazel, use the `uv`-managed virtualenv:
+
+```bash
+cd garage_python
+uv sync --extra dev
+uv run pytest -q
+```
+
+The lockfile resolves for macOS only; on Linux use
+`uv venv --python 3.14 .venv && uv pip install -e '.[dev]'`, then `.venv/bin/pytest -q`.
+`tests/test_postgres.py` runs against a real server when `GARAGE_TEST_DATABASE_URL` is set (see
+"Testing against Postgres" in `../CLAUDE.md`).
+
+## Documentation
+
+`../docs/` — [architecture](https://github.com/rickmark/garage-rag/blob/main/docs/architecture.md), [schema](https://github.com/rickmark/garage-rag/blob/main/docs/schema.md),
+[attribution](https://github.com/rickmark/garage-rag/blob/main/docs/attribution.md), [privacy](https://github.com/rickmark/garage-rag/blob/main/docs/privacy.md), plus support and
+troubleshooting guides. The generated config schema is committed at
+`../docs/.data/garage.schema.json` and served as `https://garagerag.app/.data/garage.schema.json`.

garage_rag-1.5.0/README.md

@@ -0,0 +1,82 @@
+# garage_rag
+
+The Python half of [Garage](https://github.com/rickmark/garage-rag#readme): a local-first personal RAG pipeline over
+PostgreSQL + pgvector. It walks personal documents, code repositories and communications,
+extracts and chunks their text, attributes authorship, embeds every chunk under each
+registered model, distills documents into span-grounded facts, and serves the corpus over
+MCP 2.0 and gRPC. Garage never sends communications off the machine (MCP clients you connect still receive what they retrieve); see [`docs/privacy.md`](https://github.com/rickmark/garage-rag/blob/main/docs/privacy.md).
+
+## Entry points
+
+| Command | Module | Role |
+|---|---|---|
+| `garage` | `garage_rag.cli:main_cli` | ingest, backfill, enrich-facts, search, config, model registry, `serve` (gRPC bridge for the macOS app) |
+| `garage-mcp` | `garage_rag.mcp_server.server:main` | MCP 2.0 server over stdio, the command MCP clients spawn (`garage mcp-install --stdio` wires it into Claude Desktop/Code); `garage mcp-serve` runs the HTTP server |
+
+Both are console scripts of the `garage_rag` package. The macOS app does not
+ship them as standalone binaries: it bundles the package as
+`site-python` inside `Frameworks/PythonXPCService.framework` (`//garage_python:site-packages`) and runs it through
+Swift launchers that embed the bundled interpreter, packaged as helper bundles
+(`Contents/Helpers/garage.app` and `garage-mcp.app`, `//macapp/Sources/GarageCLI:garage_app` and
+`//macapp/Sources/GarageMCPCLI:garage_mcp_app`) and reached through the stable paths
+`Contents/MacOS/garage` and `garage-mcp`. Those launchers find or start the app's database and
+export `GARAGE_DATABASE_URL`; the console scripts from a venv do not.
+
+## Layout
+
+```
+src/garage_rag/
+  ingest/     walker, materialization budget, chunking, scanner, pipeline, Messages threads,
+              the storage gateway (in-process SQLAlchemy, or gRPC for the XPC workers)
+  extract/    per-format extractors (text, PDF, Office, images via in-process Tesseract, mail) + quality gate
+  attribute/  git / metadata / path-rule / message-sender authorship signals
+  embed/      embedding backends (Ollama, LM Studio, llama XPC) and backfill
+  enrich/     fact distillation (vendored local LangExtract subset) and local generation
+  inference/  the one HTTP client for LM Studio, Ollama and the app's LlamaXPCService
+  net/        egress.py, the only module that opens outbound connections
+  search/     hybrid RRF search
+  mcp_server/ MCP tools and client registration (mcp-install)
+  service/    gRPC GarageService (proto/garage.proto) and its client
+  ops/        the operations the CLI and the gRPC handlers both present
+  xpc/        hooks for the app's XPC hosts (llama_xpc client, model loader)
+  native/     finds libpq / libtesseract already loaded into the process
+  db/         SQLAlchemy models mirroring data/sql/00*.sql, migrations, model registry
+  config/     garage.json settings and the generated JSON Schema
+tests/        pytest suite, one Bazel py_test target per file
+```
+
+## Building and testing
+
+Everything is driven by the Aspect CLI from the repository root:
+
+```bash
+aspect build //garage_python:site-packages
+aspect test //garage_python/tests:suite
+aspect test //garage_python/tests:test_facts --bazel-flag=--test_arg=-k --bazel-flag=--test_arg=some_case
+```
+
+`tests/BUILD.bazel` has one `py_test` per file (via `//tools/pytest:defs.bzl`, which drives
+pytest); `aspect gazelle` writes the target for a new test file, and the `suite` list is kept by
+hand. Third-party
+dependencies live in `pyproject.toml` and are locked with `uv` (`../tools/repin`), exposed to
+Bazel as `@pypi//<package>`.
+
+For quick iteration outside Bazel, use the `uv`-managed virtualenv:
+
+```bash
+cd garage_python
+uv sync --extra dev
+uv run pytest -q
+```
+
+The lockfile resolves for macOS only; on Linux use
+`uv venv --python 3.14 .venv && uv pip install -e '.[dev]'`, then `.venv/bin/pytest -q`.
+`tests/test_postgres.py` runs against a real server when `GARAGE_TEST_DATABASE_URL` is set (see
+"Testing against Postgres" in `../CLAUDE.md`).
+
+## Documentation
+
+`../docs/` — [architecture](https://github.com/rickmark/garage-rag/blob/main/docs/architecture.md), [schema](https://github.com/rickmark/garage-rag/blob/main/docs/schema.md),
+[attribution](https://github.com/rickmark/garage-rag/blob/main/docs/attribution.md), [privacy](https://github.com/rickmark/garage-rag/blob/main/docs/privacy.md), plus support and
+troubleshooting guides. The generated config schema is committed at
+`../docs/.data/garage.schema.json` and served as `https://garagerag.app/.data/garage.schema.json`.

garage_rag-1.5.0/hatch_build.py

@@ -0,0 +1,36 @@
+"""Hatch build hook: ship the repository's ``data/`` artifacts inside the package.
+
+The pipeline reads the SQL migrations (``data/sql``) and the model catalog
+(``data/models/models.json``) from the repository root, which a wheel installed
+from PyPI does not have. This copies them into the package as
+``garage_rag/_data``, where ``garage_rag.config.data_dir`` looks first.
+
+It only acts when ``../data`` exists, that is, when building from the checkout.
+The sdist carries the files under ``src/garage_rag/_data``, so a wheel built
+from the sdist picks them up as ordinary package files.
+"""
+
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+# (source relative to the repository's data/, glob) for each artifact the package needs.
+ARTIFACTS = [("sql", "*.sql"), ("models", "models.json")]
+
+
+class DataBuildHook(BuildHookInterface):
+    PLUGIN_NAME = "garage-data"
+
+    def initialize(self, version: str, build_data: dict) -> None:
+        if self.target_name == "wheel" and version != "standard":
+            return  # editable installs read data/ from the checkout
+        data = Path(self.root).parent / "data"
+        if not data.is_dir():
+            return
+        prefix = "src/garage_rag/_data" if self.target_name == "sdist" else "garage_rag/_data"
+        for subdir, pattern in ARTIFACTS:
+            files = sorted((data / subdir).glob(pattern))
+            if not files:
+                raise FileNotFoundError(f"no {pattern} under {data / subdir}")
+            for path in files:
+                build_data["force_include"][str(path)] = f"{prefix}/{subdir}/{path.name}"

garage_rag-1.5.0/pyproject.toml

@@ -0,0 +1,145 @@
+[project]
+name = "garage_rag"
+version = "1.5.0"
+description = "Local-first personal RAG pipeline over Postgres + pgvector, with authorship attribution and an MCP server"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "Rick Mark-Penwell" }]
+requires-python = ">=3.13,<3.15"
+keywords = ["rag", "mcp", "pgvector", "postgres", "embeddings", "search"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Text Processing :: Indexing",
+]
+
+dependencies = [
+    # storage
+    "sqlalchemy>=2.0",
+    "psycopg[pool]>=3.2",
+    "pgvector>=0.5,<0.6",
+    # document extraction (all permissive licenses; PyMuPDF avoided due to AGPL)
+    "pypdf>=6.16",
+    "pdfplumber>=0.11.10",
+    # Not imported directly: pulled in transitively by pdfminer-six (pdfplumber).
+    # The old <44 ceiling had no recorded reason and blocked the free-threaded
+    # build: 43.x has no cp314t wheels and does not build from source there.
+    "cryptography>=44",
+    "python-docx>=1.2",
+    "python-pptx>=1.0.2",
+    "openpyxl>=3.1.5",
+    # OCR
+    "pillow>=11.0",
+    # fact extraction: the vendored LangExtract subset (garage_rag/enrich/langextract)
+    # needs regex for its tokenizer.
+    "regex>=2023.0.0",
+    # the egress guard's HTTP client (garage_rag/net/egress.py), which every
+    # outbound HTTP request goes through, garage_rag/inference's included
+    "httpx>=0.28",
+    # MCP server (2.x renamed FastMCP -> MCPServer; 1.x is incompatible)
+    "mcp[cli]==2.1.0",
+    # HTTP transport for garage-mcp (mcp_server/server.py imports it directly)
+    "uvicorn>=0.30",
+    # plumbing
+    "typer>=0.15",
+    "pydantic>=2.7.4",
+    "rich>=13.9",
+    "pyyaml>=6.0",
+    # A runtime dep on purpose: the Bazel @pypi hub (--@pypi//dep_group=garage_rag)
+    # only exposes packages reachable from [project.dependencies], so the py_test
+    # targets can't resolve @pypi//pytest from an optional/dev group.
+    "pytest>=9.1.1",
+    # gRPC & Protobuf
+    "grpcio>=1.68.0",
+    "protobuf>=5.29.0",
+    # Not imported by garage_rag: the macOS app's embedded interpreter imports them at start-up so
+    # ssl's default contexts verify against the system trust store (certifi is the fallback). The
+    # bundled OpenSSL has no CA files of its own.
+    "truststore>=0.10",
+    "certifi>=2024.2.2",
+]
+
+[project.optional-dependencies]
+# Local tooling for the uv venv only; the Bazel @pypi hub does not expose this group.
+dev = [
+    "pytest-asyncio>=0.24",
+    "ruff>=0.8",
+    "grpcio-tools>=1.68.0",
+    # tools/swiftcheck: Swift syntax checking where no Swift toolchain exists (Linux, web sessions)
+    "tree-sitter>=0.25",
+    "tree-sitter-swift>=0.7",
+    # garage_python/tests/fake_messages.py: the invented people and messages in the fake chat.db
+    "faker>=37",
+]
+# aspect_rules_py builds sdists into wheels with `build` and `setuptools`, resolved from uv.lock
+# and from the hub's dependency group. grpcio ships no free-threaded (cp314t) wheels, so the 3.14t
+# build compiles it from source. The Bazel group below pulls this extra in.
+build-tools = ["build", "setuptools"]
+
+[dependency-groups]
+# The @pypi hub's group (`--@pypi//dep_group=garage_rag` in .bazelrc). Without a
+# [dependency-groups] table the hub derives it from the project alone; declaring one replaces that,
+# so it names the project itself, plus the sdist build tools.
+garage_rag = ["garage_rag[build-tools]"]
+
+[project.urls]
+Homepage = "https://garagerag.app"
+Source = "https://github.com/rickmark/garage-rag"
+Issues = "https://github.com/rickmark/garage-rag/issues"
+
+[project.scripts]
+garage = "garage_rag.cli:main_cli"
+garage-mcp = "garage_rag.mcp_server.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/garage_rag"]
+exclude = ["BUILD.bazel"]
+
+# PyPI's sdist: the package and its build hook, without the tests (their corpora are most of the
+# size) or the Bazel and uv files.
+[tool.hatch.build.targets.sdist]
+include = ["/src/garage_rag", "/hatch_build.py", "/README.md", "/LICENSE"]
+exclude = ["BUILD.bazel"]
+
+# hatch_build.py: copies ../data/sql and ../data/models/models.json into the package as
+# garage_rag/_data, which a PyPI install reads in place of the repository's data/.
+[tool.hatch.build.hooks.custom]
+
+[tool.uv]
+environments = ["sys_platform == 'darwin' and platform_machine == 'arm64'"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py313"
+# Vendored third-party code keeps its upstream style (see its __init__ docstring), and the test
+# corpora are upstream copies too (ruff also formats the code blocks in their Markdown).
+extend-exclude = ["*_pb2.py", "*_pb2_grpc.py", "*_pb2.pyi", "src/garage_rag/enrich/langextract", "tests/corpora"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["garage_rag"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+filterwarnings = ["error::DeprecationWarning"]
+
+[tool.ty.src]
+# Generated protobuf stubs are excluded from type checking, as they are from Ruff
+# above. `exclude` lives under `src` for ty; a top-level `[tool.ty] exclude` is a
+# hard config error that makes ty exit non-zero before it checks anything.
+exclude = ["*_pb2.py", "*_pb2_grpc.py", "*_pb2.pyi", "src/garage_rag/enrich/langextract"]
+
+[tool.ty.rules]
+unresolved-import = "ignore"

garage_rag-1.5.0/src/garage_rag/__init__.py

@@ -0,0 +1,15 @@
+"""garage-rag: a local-first personal RAG pipeline.
+
+Indexes personal documents into Postgres + pgvector, preserving authorship,
+reference, and communication distinctions, and exposes the corpus to Claude
+through an MCP server.
+"""
+
+__version__ = "1.5.0"
+
+# Must run before psycopg is imported anywhere in the package: makes psycopg's
+# ctypes based libpq lookup use the signed copy the app's framework has loaded
+# instead of a Homebrew/system library that dyld rejects.
+from . import libpq as _libpq  # noqa: E402
+
+_libpq.configure()