Skip to content
Astrocyte — memory framework for AI agents Astrocyte — memory framework for AI agents Astrocyte

Storage adapter packages

Astrocyte ships separate PyPI packages per backend. They implement the Tier 1 SPIs in astrocyte.provider (GraphStore, DocumentStore, VectorStore).

In this repository: adapters-storage-py/ packages include astrocyte-pgvector (PostgreSQL + pgvector), astrocyte-qdrant, astrocyte-neo4j, and astrocyte-elasticsearch — each with its own pyproject.toml and published image or wheel workflows as applicable.

Conformance

Section titled “Conformance”

Each adapter should run the same style of tests as:

  • Vector: astrocyte-py/tests/test_spi_vector_store_contract.py (copy or import patterns into the adapter repo’s CI).
  • Graph / document: mirror the same idea — exercise every protocol method against a disposable test instance.
Section titled “Repository layout (recommended)”
  • Option A — Monorepo: astrocyte-qdrant/, astrocyte-graph-neo4j/, … as top-level siblings under the org repo, each with its own pyproject.toml and astrocyte as a version-pinned dependency.
  • Option B — Multi-repo: one GitHub repo per adapter; publish independently.

Versioning

Section titled “Versioning”

Pin a supported astrocyte minor for SPI stability; bump adapter major when SPI major bumps.