Skip to main content

Pure in-memory, ephemeral database storage for elizaOS

Project description

elizaos-plugin-inmemorydb

A pure in-memory, ephemeral database adapter for elizaOS (Python implementation). All data is completely lost on process restart or when close() is called.

Features

  • Zero Configuration: No database setup required - just works out of the box
  • Zero Persistence: Data is never written to disk
  • Completely Ephemeral: All data is lost when the process ends
  • Vector Search: Built-in HNSW index for semantic similarity search (also ephemeral)
  • Async Support: Full async/await support with Python 3.11+

When to Use

This plugin is ideal for:

  • Testing and CI/CD: Perfect for tests that need a fresh database each run
  • Stateless deployments: When you want agents to start fresh each time
  • Development: Quick prototyping without persistence overhead
  • Privacy-focused applications: When data should never be stored
  • Demos and examples: Clean slate for each demonstration

Not recommended for:

  • ❌ Production systems that need data persistence
  • ❌ Long-running agents that need to remember past interactions
  • ❌ Multi-process deployments (data is not shared between processes)

Installation

pip install elizaos-plugin-inmemorydb

Quick Start

from elizaos_plugin_inmemorydb import InMemoryDatabaseAdapter, MemoryStorage

# Create storage and adapter
storage = MemoryStorage()
adapter = InMemoryDatabaseAdapter(storage, agent_id)
await adapter.init()

# Use the adapter...

# When done, close to clear all data
await adapter.close()

License

MIT

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

elizaos_plugin_inmemorydb-2.0.0a5.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

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

elizaos_plugin_inmemorydb-2.0.0a5-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

Details for the file elizaos_plugin_inmemorydb-2.0.0a5.tar.gz.

File metadata

File hashes

Hashes for elizaos_plugin_inmemorydb-2.0.0a5.tar.gz
Algorithm Hash digest
SHA256 182fd212b4dff933e3b6d4ed13ad3e63d44f6ea431657f452217c7ecb84c6ce4
MD5 ab683cb7fb15efa9b66a684b2539825f
BLAKE2b-256 d70acb1c94682819f583071708cb8d983a10c40bd1953b82ce678d72e6842d47

See more details on using hashes here.

File details

Details for the file elizaos_plugin_inmemorydb-2.0.0a5-py3-none-any.whl.

File metadata

File hashes

Hashes for elizaos_plugin_inmemorydb-2.0.0a5-py3-none-any.whl
Algorithm Hash digest
SHA256 969efc8d312bc64de072c0466efa3b642e200f1d438aaba065fafca00fbb8cd8
MD5 c7f8420d7889e68e7f45595b4022999a
BLAKE2b-256 8f81fdab7986b45b0e8cad5f46830bb9a170083c0186abd7886d0719d3313341

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