Skip to main content

Typed block tree + knowledge graph memory SDK for AI agents

Project description

MemBlock

Structured memory SDK for AI agents.

Typed blocks · Knowledge graph · Hybrid search · Encryption · Decay engine — all local, all yours.

memblock.xyz


AI agents forget everything between sessions. Vector databases give you search but no structure. Cloud memory APIs lock you in and store your users' data on someone else's servers. MemBlock is the alternative: typed memory blocks, a built-in knowledge graph, hybrid search, encryption, and intelligent decay — all running on your infrastructure with pip install and one line of Python. No Docker, no Neo4j, no subscriptions. Your data never leaves your machine.

Install

pip install memblock

Quick Start

from memblock import MemBlock, BlockType

mem = MemBlock(storage="sqlite:///memory.db")

# Store structured memories
mem.store("User prefers Python", type=BlockType.PREFERENCE)
mem.store("User works at Acme Corp", type=BlockType.FACT, confidence=0.95)

# Query with hybrid search
results = mem.query(text_search="programming", type=BlockType.PREFERENCE)

# Build LLM-ready context
context = mem.build_context(query="user preferences", token_budget=4000)

# Knowledge graph
mem.link(results[0].id, other.id, relation="related_to")

# Tamper detection
mem.verify()

Optional Extras

pip install "memblock[postgres]"            # PostgreSQL backend
pip install "memblock[embeddings]"          # Local vector embeddings (FastEmbed)
pip install "memblock[llm]"                 # LLM extraction (OpenAI, Anthropic, Gemini)
pip install "memblock[reranker-cohere]"     # Cohere reranker
pip install "memblock[reranker-cross-encoder]"  # HuggingFace reranker
pip install "memblock[all-cloud]"           # Everything without onnxruntime (Python 3.13+)
pip install "memblock[all]"                 # Everything including local embeddings

Documentation

Full docs, API reference, and examples: memblock.xyz

License

Proprietary. Copyright (c) 2025-2026 iexcalibur. All Rights Reserved.

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

memblock-0.9.0.tar.gz (128.2 kB view details)

Uploaded Source

Built Distribution

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

memblock-0.9.0-py3-none-any.whl (99.0 kB view details)

Uploaded Python 3

File details

Details for the file memblock-0.9.0.tar.gz.

File metadata

  • Download URL: memblock-0.9.0.tar.gz
  • Upload date:
  • Size: 128.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for memblock-0.9.0.tar.gz
Algorithm Hash digest
SHA256 d84d29b02580a6444f8a83a391d3b07f68baae655597d957036e4037fb459807
MD5 7dc5ba9fe9b5ba8b1627b567ca6551fc
BLAKE2b-256 552b7052ba3c7e51d98a54a01c10921cfae49244d1ca2523761064fcdf5d4a97

See more details on using hashes here.

File details

Details for the file memblock-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: memblock-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 99.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for memblock-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d04c8d7058d69078f41fc6c20c97a8a6a7f1064f348921c54b97d99a59f87ca4
MD5 f0dc92518ed737c05d064f71c1dba723
BLAKE2b-256 68c4fd99ca6fe6ea2b45e838ff4beb8a2f8e481b2c8c88c7602ee03d26674e92

See more details on using hashes here.

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