`dbx-tools-graphiti`

Run Graphiti REST, MCP, model routing, and PostgreSQL-backed graph memory from one Python runtime. The build synchronizes the upstream REST and MCP source plus the pinned PostGraph driver from Graphiti PR 1777 into the generated package tree, so the published wheel has no direct Git dependencies.

Both upstream surfaces come from the same Graphiti commit:

graph-service from server/
mcp-server from mcp_server/

Run

GRAPHITI_LISTEN=tcp://0.0.0.0:8000 \
uv run python -m dbx_tools.graphiti

From the repository root, the local launcher starts the unified runtime:

DATABRICKS_CONFIG_PROFILE=<profile> \
MODEL_NAME=databricks-gpt-5-nano \
bash scripts/run-graphiti-python.sh

The combined application exposes:

FastAPI documentation at /docs
OpenAPI at /openapi.json
REST health and Graphiti routes, including /healthcheck, /search, and ingestion endpoints
direct tool operations under /tools/*
Streamable HTTP MCP at /mcp/

Configure Graphiti through the shared environment contract used by the Node runtime and CLI.

The package also provides an environment-configured server entry point and a schema-only command:

python -m dbx_tools.graphiti
python -m dbx_tools.graphiti docs

docs writes the OpenAPI JSON document to stdout and exits without starting the database runtime.

Databricks Model Resolution

The process creates one generated auth client and one generated model client at startup. It resolves the fuzzy chat model, ranks embedding endpoints by the configured name, embedding class, and dimensions, then resolves both endpoint routes. REST and MCP reuse the same Graphiti model clients, while the auth client injects refreshed Databricks headers into every model request.

Use From A Notebook

Use the same resolved option names without starting Uvicorn:

from dbx_tools.graphiti.runtime import GraphitiRuntime

async with GraphitiRuntime.from_options(
    {
        "profile": "MY-PROFILE",
    }
) as runtime:
    graphiti = runtime.graphiti

When databaseUrl is omitted, the runtime starts bundled PostgreSQL with pgvector and persists it under graphitiHome, or the platform data directory when no home is configured. The owned PostgreSQL process stops with the runtime, while its data remains for the next start.

Pass a regular PostgreSQL URL to use an existing database. A passwordless non-local URL, Lakebase resource path, or Lakebase project name is resolved by the generated Node Lakebase client. It injects a fresh short-lived credential whenever the asyncpg pool opens a physical connection, without persisting that credential in the URL.

Composition Boundary

dbx_tools.graphiti.main adds FastAPI REST and MCP surfaces around the same importable runtime. Shared environment options are parsed through generated PythonMonkey bindings and mapped into both upstream settings objects.

Metadata

Release files for dbx-tools-graphiti 0.9.51

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dbx-tools-graphiti 0.9.51
File	Size	Uploaded
dbx_tools_graphiti-0.9.51.tar.gz	538.2 kB	Oct 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for dbx-tools-graphiti 0.9.51
File	Interpreter	ABI	Platform	Reset
dbx_tools_graphiti-0.9.51-py3-none-any.whl 578.9 kB Oct 7, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / dbx_tools_graphiti-0.9.51.tar.gz

Download URL	dbx_tools_graphiti-0.9.51.tar.gz
Size	538.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`224a18592e4afc902ef6b9ef34a05348528c8b67dbb335abc2f065cf9a74f359`
BLAKE2b-256 checksum How to use checksums	`38d80bed44fcb85add98effe2dde4b511bb7eaac584d81d7d3e64d9d4ffb059d`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/reggie-db/dbx-tools
Publishing commit: github.com/reggie-db/dbx-tools/tree/01854ff8a2da6ad513dd09591a3af23c0c0ba26d

Workflow

Publishing configuration: github.com/reggie-db/dbx-tools/blob/01854ff8a2da6ad513dd09591a3af23c0c0ba26d/.github/workflows/release.yml
Publishing logs: github.com/reggie-db/dbx-tools/actions/runs/37560697630/attempts/1

Artifact

Subject: dbx_tools_graphiti-0.9.51.tar.gz
SHA-256 checksum: 224a18592e4afc902ef6b9ef34a05348528c8b67dbb335abc2f065cf9a74f359 Verifying attestations

Release files / dbx_tools_graphiti-0.9.51-py3-none-any.whl

Download URL	dbx_tools_graphiti-0.9.51-py3-none-any.whl
Size	578.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a1175f11222c104532a7415c731c5d188912bc69c28736d5156d988c4cb865cd`
BLAKE2b-256 checksum How to use checksums	`986078aa91dc16f24abc34367fc34eb61b8ac8342803da164cfbaf94a245de8e`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/reggie-db/dbx-tools
Publishing commit: github.com/reggie-db/dbx-tools/tree/01854ff8a2da6ad513dd09591a3af23c0c0ba26d

Workflow

Publishing configuration: github.com/reggie-db/dbx-tools/blob/01854ff8a2da6ad513dd09591a3af23c0c0ba26d/.github/workflows/release.yml
Publishing logs: github.com/reggie-db/dbx-tools/actions/runs/37560697630/attempts/1

Artifact

Subject: dbx_tools_graphiti-0.9.51-py3-none-any.whl
SHA-256 checksum: a1175f11222c104532a7415c731c5d188912bc69c28736d5156d988c4cb865cd Verifying attestations