Skip to main content

SQLite-backed MemoryStore and VectorStore for AgentForge

Project description

agentforge-memory-sqlite

SQLite-backed MemoryStore and VectorStore for AgentForge.

Zero external services required — the database lives in a single file (or :memory: for tests). Suitable for development, single-host deployments, and small-to-medium RAG corpora (~10k vectors).

Install

uv add agentforge-memory-sqlite

Usage

from agentforge_memory_sqlite import SqliteMemoryStore, SqliteVectorStore

# Claim audit log
async with SqliteMemoryStore.from_path("agent.db") as memory:
    await memory.put(claim)

# Semantic search
async with SqliteVectorStore.from_path("agent.db", dimensions=1024) as store:
    await store.upsert(items)
    matches = await store.search(query_vector, limit=5)

Both classes pass agentforge_core.testing.run_memory_conformance / run_vector_conformance so they're drop-in replacements for the in-memory defaults.

Performance

SqliteVectorStore does brute-force cosine search in Python: O(N) per query. Fine for ~10k vectors; sluggish past that. v0.2 will add an opt-in sqlite-vec extension path declared via the "native_ann" capability flag.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentforge_memory_sqlite-0.4.0.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentforge_memory_sqlite-0.4.0-py3-none-any.whl (16.6 kB view details)

Uploaded Python 3

File details

Details for the file agentforge_memory_sqlite-0.4.0.tar.gz.

File metadata

  • Download URL: agentforge_memory_sqlite-0.4.0.tar.gz
  • Upload date:
  • Size: 16.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentforge_memory_sqlite-0.4.0.tar.gz
Algorithm Hash digest
SHA256 3bab124162c61ebe7d8f75e8a67f557fd8e50847d20e410a82b2decde12a148d
MD5 0f36de28d8b630c326dde2d27139ddaf
BLAKE2b-256 905dec83bf95c33ab62869a94868407ed8b4d38a804ab1d9e64f68dc6e06b8ee

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentforge_memory_sqlite-0.4.0.tar.gz:

Publisher: release.yml on Scaffoldic/agentforge-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentforge_memory_sqlite-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agentforge_memory_sqlite-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 155cf3e7ff2e5f8c40ae7908c9da54c9bb1e2c1c57fa271c69b9628c97d87a63
MD5 4e597e2e2bf74fe60859acff0c8c6f58
BLAKE2b-256 f5d0b11a48cc26a95e4929f0b327ae24584cade03165d67a68d20be230bbccb3

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentforge_memory_sqlite-0.4.0-py3-none-any.whl:

Publisher: release.yml on Scaffoldic/agentforge-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page