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.3.0.tar.gz (16.4 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.3.0-py3-none-any.whl (16.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentforge_memory_sqlite-0.3.0.tar.gz
  • Upload date:
  • Size: 16.4 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.3.0.tar.gz
Algorithm Hash digest
SHA256 97a876250933541629fe9976eb6a92965d6a0d852e6f5eaf7edbf5e4903f7c81
MD5 b40700a64d9926a1f60d4bc8056e80ec
BLAKE2b-256 7ce10e8a0da5e93f6b542222f4605a4181b3d7fa3a79eabaf89d85ac9f6ff4fa

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentforge_memory_sqlite-0.3.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.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for agentforge_memory_sqlite-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 34075b2274a44c962e1788765ea8bec0b4596aae1b7c634d239a6b0852ce7d4f
MD5 b5ad3e5de2fdb4e9fc955375c52a2539
BLAKE2b-256 af37176226f26abde8f8c5518db0470b8e1d43254e55f94c384fb82adf77d648

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentforge_memory_sqlite-0.3.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