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.0a4.tar.gz (13.2 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.0a4-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for elizaos_plugin_inmemorydb-2.0.0a4.tar.gz
Algorithm Hash digest
SHA256 59cba7f20d72ee2a826e9904d073f5350da20bd6353c9c1d9f48c83f3a8ffdff
MD5 589dc5cfcda0fcaa563d3d0c4cc18481
BLAKE2b-256 1ac834b54d15be30ec0037b3223258dd28fd13f787d645b70ff89101614433c1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for elizaos_plugin_inmemorydb-2.0.0a4-py3-none-any.whl
Algorithm Hash digest
SHA256 dff77df64a2f34db1f7038256057322c247bd11b8faa43ecbd36c76282772e0f
MD5 325bedb99556422f218e7f5c506a4e3f
BLAKE2b-256 e0146b4f02c6ce10624e7b2b7d991224e27d9d59918f248f39ed1eabd4d1b36c

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