Skip to main content

An open-source memory layer for humans. Cryptographically verified, encrypted, permanent memory records.

Project description

๐Ÿง  DiaryVault Memory Layer

An open-source memory layer for humans.

Your journal. Your memories. Your keys. Immutable. Verifiable. Forever.

License: MIT CI Python 3.10+ PyPI PRs Welcome


The Problem

Every day, you generate thousands of thoughts, decisions, and experiences. They live in your head โ€” and your head forgets.

Meanwhile:

  • AI can now generate fake photos, voices, text, and video indistinguishable from reality
  • Your personal data is scattered across platforms you don't control
  • There is no verifiable, tamper-proof record that you lived your life

Planes have black boxes. Cars have dash cams. Companies have audit logs.

Humans have nothing.

The Vision

DiaryVault Memory Layer is an open-source framework that turns your daily journal entries into cryptographically verified, encrypted, permanent memory records.

Think of it as a personal black box for your life.

You write โ†’ AI enriches โ†’ System encrypts โ†’ Hash anchors โ†’ Memory preserved forever

Your future personal AI โ€” your copilot, your digital twin, your legacy โ€” will need a trusted memory source. This is that source.

Quick Start

pip install diaryvault-memory
from diaryvault_memory import MemoryVault

# Initialize your vault
vault = MemoryVault(encryption_key="your-secret-key")

# Create an immutable memory
memory = vault.create(
    content="Today I decided to quit my job and start a company. "
            "I've never been more terrified or more alive.",
    tags=["career", "milestone", "2025"]
)

# Memory is now:
# โœ“ SHA-256 hashed
# โœ“ AES-256 encrypted
# โœ“ Timestamped (RFC 3339)
# โœ“ Signed with your key
print(memory.hash)       # a7f3b2c1d4e5...
print(memory.timestamp)  # 2025-02-07T14:32:01Z
print(memory.verified)   # True

# Verify integrity at any point
assert vault.verify(memory) == True

# Anchor to permanent storage (optional)
vault.anchor(memory, backend="arweave")  # or "ethereum", "local"

That's it. Your memory is now immutable, encrypted, and optionally anchored on-chain.

How It Works

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                    YOUR LIFE                             โ”‚
โ”‚  journals ยท photos ยท decisions ยท health ยท thoughts      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
                  โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              CAPTURE LAYER                               โ”‚
โ”‚  Manual entries ยท AI agents ยท API integrations           โ”‚
โ”‚  Calendar sync ยท Photo capture ยท Voice notes             โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
                  โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              SYNTHESIS LAYER                              โ”‚
โ”‚  AI narrative generation ยท Summarization                 โ”‚
โ”‚  Pattern detection ยท Emotional analysis                  โ”‚
โ”‚  Context enrichment ยท Cross-reference                    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
                  โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              VERIFICATION LAYER                           โ”‚
โ”‚  SHA-256 hashing ยท AES-256 encryption                    โ”‚
โ”‚  RFC 3339 timestamping ยท Digital signatures               โ”‚
โ”‚  Merkle tree for batch verification                      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
                  โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚              PERMANENCE LAYER                             โ”‚
โ”‚  Local encrypted storage ยท Arweave ยท IPFS                โ”‚
โ”‚  Ethereum L2 hash anchoring ยท Personal servers           โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Features

๐Ÿ” Military-Grade Encryption โ€” AES-256-GCM encryption. Your memories are unreadable without your key. Not even we can read them.

๐Ÿ”— Cryptographic Verification โ€” Every entry is SHA-256 hashed and timestamped. Prove when you wrote what you wrote.

๐ŸŒ Blockchain Anchoring โ€” Optionally anchor hashes to Arweave, Ethereum L2, or IPFS for tamper-proof permanence. No tokens required.

๐Ÿค– AI Agent Framework โ€” Pluggable agents that capture, synthesize, and enrich your daily memories. Bring your own LLM.

๐Ÿ“ฆ Open Memory Format โ€” .dvmem โ€” a documented, open format so your data is never locked in. Export anytime.

๐Ÿ”‘ Dead Man's Switch โ€” Designate trusted parties who can access your vault after a configurable inactivity period.

๐Ÿ  Self-Hostable โ€” Run entirely on your own hardware. No cloud required. No trust required.

Architecture

See ARCHITECTURE.md for the full technical deep dive.

The system is built on four principles:

  1. Privacy First โ€” Encryption happens client-side before anything leaves your device
  2. Verify Everything โ€” Every operation produces a cryptographic proof
  3. Own Your Data โ€” Open formats, open code, export anytime
  4. Permanence Optional โ€” Choose your storage backend: local, cloud, or blockchain

Use Cases

Use Case Description
Digital Legacy Preserve your life story for future generations
Legal Evidence Timestamped, tamper-proof personal records
AI Twin Training Structured life data for training your personal AI
Health Timeline Verifiable medical history and symptom tracking
Estate Planning Secure vault with designated beneficiary access
Identity Proof Continuous proof-of-humanity through narrative
Memory Aid AI-powered recall for important life events

Roadmap

  • Core SDK โ€” hash, encrypt, verify, store
  • Memory format spec (.dvmem)
  • AI synthesis agents (v0.2)
  • Arweave anchoring (v0.3)
  • Ethereum L2 anchoring (v0.3)
  • Photo/voice capture agents (v0.4)
  • Dead man's switch (v0.5)
  • Personal AI training export (v0.6)
  • Mobile SDK (v0.7)
  • DiaryVault app integration (v1.0)

Built By

DiaryVault โ€” AI-powered journaling for the modern human.

The Memory Layer is the open-source foundation. DiaryVault is the beautiful app built on top of it.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Priority areas:

  • Storage backend adapters (IPFS, Filecoin, Ceramic)
  • AI agent plugins
  • Language SDKs (TypeScript, Rust, Go)
  • Mobile integration
  • Documentation and tutorials

Philosophy

"The palest ink is better than the best memory." โ€” Chinese Proverb

We believe your memories belong to you. Not to a platform. Not to a corporation. Not to an algorithm.

The Memory Layer is infrastructure for a future where every human has a verified, permanent, private record of their existence โ€” accessible to them, inheritable by their loved ones, and uneditable by anyone else.

This is not a product. It's a protocol. Build on it.

License

MIT โ€” Use it. Fork it. Build on it. Remember everything.


Own your life story forever.
diaryvault.com ยท @diaryvault ยท Discord

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

diaryvault_memory-0.1.0.tar.gz (20.8 kB view details)

Uploaded Source

Built Distribution

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

diaryvault_memory-0.1.0-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file diaryvault_memory-0.1.0.tar.gz.

File metadata

  • Download URL: diaryvault_memory-0.1.0.tar.gz
  • Upload date:
  • Size: 20.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.16

File hashes

Hashes for diaryvault_memory-0.1.0.tar.gz
Algorithm Hash digest
SHA256 55d8617b95ccbf52f66f51bbce38d99fe4f19183eafa5351424fdb122e043744
MD5 743f82e4b18e4c65a3681842e64f8444
BLAKE2b-256 4218c68012c77b522cda8350ede2b0857fa9f1ca721a221bcad0f222bded3379

See more details on using hashes here.

File details

Details for the file diaryvault_memory-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for diaryvault_memory-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 83e783241dff82768196da275451007de3ef78f5afc73f397aa46fc47f48d397
MD5 1d00e633513655e5339334c0d4e47a25
BLAKE2b-256 f9d7149cd966bcd85a1014cd399498d4bbcd74608bb361cfd18654363a46ae79

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