SimpleMem
SimpleMem: Efficient Lifelong Memory for LLM Agents — Text & Multimodal
File Explorer
- __init__.py
- conftest.py
- test_collectors.py
- test_consolidation.py
- test_context_injector.py
- test_e2e.py
- test_orchestrator.py
- test_session_lifecycle.py
- test_storage.py
- test_types.py
- __init__.py
- api_http.py
- api_mcp.py
- collectors.py
- consolidation.py
- context_injector.py
- hooks.py
- orchestrator.py
- README.md
- session_manager.py
- storage_lancedb.py
- storage_sqlite.py
- types.py
- README.ar.md
- README.de.md
- README.es.md
- README.fr.md
- README.it.md
- README.ja.md
- README.ko.md
- README.pt-br.md
- README.ru.md
- README.tr.md
- README.vi.md
- README.zh-CN.md
- PACKAGE_USAGE.md
- text-memory.md
- __init__.py
- base.py
- locomo.py
- longmemeval.py
- membench.py
- metrics.py
- __init__.py
- candidate.py
- config.py
- consolidator.py
- diagnosis.py
- embeddings.py
- evolution.py
- evolution_cookbook.py
- extractor.py
- kg.py
- manager.py
- meta_analysis.py
- metrics.py
- models.py
- multi_retriever.py
- policy.py
- policy_optimizer.py
- policy_store.py
- promotion.py
- replay.py
- retriever.py
- scope.py
- self_upgrade.py
- store.py
- telemetry.py
- upgrade_worker.py
- README.md
- requirements.txt
- run_benchmark.py
- run_evolution.py
- quickstart.py
- atlas-cloud-logo.png
- Fig_framework.png
- Fig_icon.png
- Fig_tradeoff.png
- simplemem-new.mp4
- wechat_logo3.JPG
- __init__.py
- settings.py
- app.js
- index.html
- style.css
- __init__.py
- answer_generator.py
- hybrid_retriever.py
- memory_builder.py
- vector_store.py
- Fig_framework.png
- Fig_icon.png
- Fig_tradeoff.png
- simplemem-new.mp4
- wechat_logo.jpg
- __init__.py
- memory_entry.py
- load_dataset.py
- test_advanced.py
- utils.py
- __init__.py
- embedding.py
- llm_client.py
- .gitignore
- config.py.example
- main.py
- README.md
- requirements.txt
- test_locomo10.py
- __init__.py
- models.py
- token_manager.py
- __init__.py
- answer_generator.py
- memory_builder.py
- retriever.py
- __init__.py
- user_store.py
- vector_store.py
- __init__.py
- ollama.py
- openrouter.py
- requesty.py
- __init__.py
- http_server.py
- mcp_handler.py
- init.sh
- README.md
- register.py
- requirements.txt
- run.py
- run.sh
- test_ollama.py
- efficiency.png
- framework.png
- __init__.py
- run_locomo.py
- ar_prompt.txt
- cd_prompt.txt
- fr_prompt.txt
- kr_prompt.txt
- mr_prompt.txt
- sys_prompt.txt
- tr_prompt.txt
- ttl_prompt.txt
- vr_prompt.txt
- vs_prompt.txt
- __init__.py
- adapter.py
- __init__.py
- locomo_config.yaml
- memgallery_config.yaml
- api_server.py
- multimodal_memory.py
- quickstart.py
- __init__.py
- __main__.py
- media.py
- namespaces.py
- README.md
- server.py
- tools.py
- __init__.py
- config.py
- event.py
- mau.py
- __init__.py
- benchmarks.py
- evaluator.py
- metrics.py
- __init__.py
- evolution_config.py
- experience_engine.py
- meta_controller.py
- strategy_optimizer.py
- __init__.py
- event_manager.py
- event_store.py
- __init__.py
- entity_extractor.py
- graph_retriever.py
- knowledge_graph.py
- __init__.py
- consolidator.py
- memory_distiller.py
- parametric_store.py
- __init__.py
- audio_processor.py
- base.py
- image_processor.py
- text_processor.py
- video_processor.py
- __init__.py
- bm25_store.py
- expansion_manager.py
- pyramid_retriever.py
- query_processor.py
- __init__.py
- features.py
- policy.py
- router.py
- __init__.py
- cold_storage.py
- mau_store.py
- semantic_store.py
- vector_store.py
- __init__.py
- audio_trigger.py
- base.py
- visual_trigger.py
- __init__.py
- embedding.py
- logging_config.py
- model_utils.py
- openvision_clip.py
- __init__.py
- app.py
- orchestrator.py
- __init__.py
- test_bm25_store.py
- test_config.py
- test_knowledge_graph.py
- test_mau.py
- test_omni_mcp.py
- test_orchestrator.py
- test_text_processor.py
- test_vector_store.py
- .gitignore
- LICENSE
- README.md
- requirements.txt
- setup.py
- docker-entrypoint.sh
- __init__.py
- vector_store.py
- vector_store_backend.py
- __init__.py
- memory_entry.py
- __init__.py
- embedding.py
- llm_client.py
- __init__.py
- answer_generator.py
- config_default.py
- hybrid_retriever.py
- memory_builder.py
- settings.py
- __init__.py
- base.py
- locomo.py
- longmemeval.py
- membench.py
- metrics.py
- __init__.py
- candidate.py
- config.py
- consolidator.py
- diagnosis.py
- embeddings.py
- evolution.py
- evolution_cookbook.py
- extractor.py
- kg.py
- manager.py
- meta_analysis.py
- metrics.py
- models.py
- multi_retriever.py
- optimize.py
- policy.py
- policy_optimizer.py
- policy_store.py
- promotion.py
- replay.py
- retriever.py
- scope.py
- self_upgrade.py
- store.py
- telemetry.py
- upgrade_worker.py
- __init__.py
- settings.py
- app.js
- index.html
- style.css
- __init__.py
- answer_generator.py
- hybrid_retriever.py
- memory_builder.py
- vector_store.py
- Fig_framework.png
- Fig_icon.png
- Fig_tradeoff.png
- simplemem-new.mp4
- wechat_logo.jpg
- __init__.py
- memory_entry.py
- load_dataset.py
- test_advanced.py
- utils.py
- __init__.py
- embedding.py
- llm_client.py
- .gitignore
- config.py.example
- main.py
- README.md
- requirements.txt
- test_locomo10.py
- __init__.py
- models.py
- token_manager.py
- __init__.py
- answer_generator.py
- memory_builder.py
- retriever.py
- __init__.py
- user_store.py
- vector_store.py
- __init__.py
- ollama.py
- openrouter.py
- requesty.py
- __init__.py
- http_server.py
- mcp_handler.py
- architecture.md
- cli-reference.md
- import-guide.md
- openrouter-guide.md
- requesty-guide.md
- cli_persistent_memory.py
- __init__.py
- answer_generator.py
- hybrid_retriever.py
- memory_builder.py
- vector_store.py
- __init__.py
- memory_entry.py
- __init__.py
- embedding.py
- llm_client.py
- openrouter.py
- requesty.py
- config.py.example
- main.py
- .gitignore
- requirements.txt
- SKILL.md
- init.sh
- README.md
- register.py
- requirements.txt
- run.py
- run.sh
- test_ollama.py
- __init__.py
- config.py
- event.py
- mau.py
- __init__.py
- benchmarks.py
- evaluator.py
- metrics.py
- __init__.py
- evolution_config.py
- experience_engine.py
- meta_controller.py
- strategy_optimizer.py
- __init__.py
- event_manager.py
- event_store.py
- __init__.py
- entity_extractor.py
- graph_retriever.py
- knowledge_graph.py
- __init__.py
- consolidator.py
- memory_distiller.py
- parametric_store.py
- __init__.py
- audio_processor.py
- base.py
- image_processor.py
- text_processor.py
- video_processor.py
- __init__.py
- bm25_store.py
- expansion_manager.py
- pyramid_retriever.py
- query_processor.py
- __init__.py
- features.py
- policy.py
- router.py
- __init__.py
- cold_storage.py
- mau_store.py
- semantic_store.py
- vector_store.py
- __init__.py
- audio_trigger.py
- base.py
- visual_trigger.py
- __init__.py
- embedding.py
- logging_config.py
- model_utils.py
- openvision_clip.py
- __init__.py
- app.py
- orchestrator.py
- __init__.py
- system.py
- __init__.py
- config.py
- router.py
- architecture.md
- cli-reference.md
- import-guide.md
- openrouter-guide.md
- requesty-guide.md
- cli_persistent_memory.py
- __init__.py
- answer_generator.py
- hybrid_retriever.py
- memory_builder.py
- vector_store.py
- __init__.py
- memory_entry.py
- __init__.py
- embedding.py
- llm_client.py
- openrouter.py
- requesty.py
- config.py.example
- main.py
- .gitignore
- requirements.txt
- SKILL.md
- README.md
- load_dataset.py
- test_advanced.py
- utils.py
- test_vector_store.py
- test_vector_store_backend.py
- .dockerignore
- .env.example
- .gitignore
- config.py.example
- docker-compose.yml
- Dockerfile
- LICENSE
- main.py
- README.md
- requirements-gpu.txt
- requirements.txt
- setup.py
- SimpleMem.skill
- simplemem_router.py
- test_locomo10.py
# Installation Guide
python- Python >=3.8
- Pip latest
- Docker Desktop latest
Setup Steps
cp .env.example .env
Copy and create the environment configuration file.
pip install -e .
Install the SimpleMem package in editable mode.
docker-compose up -d
Run required backend services in the background via Docker.
Key Commands
pip install -e .
Install the package to make SimpleMem library available locally.
docker-compose up -d
Start container-based services in the background.
# Use via CDN
jsDelivrjsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.
Release Timeline
Actively Maintained- 2026-05-21 v0.3.0 — Unified SimpleMem package
- 2026-04-03 v0.2.0 — Omni-SimpleMem: Multimodal Memory
- 2026-03-10 v0.1.0 — Initial Release (Text Only)
Command Glossary
Commands referenced in this DOCs, explained below.
Bob
View Details ▼
Bob
Manage and switch between Neovim versions.
bob use {{nightly|stable|latest|version_string|commit_hash}}
Install and switch to the specified version of Neovim:
bob list
List installed and currently used versions of Neovim:
bob uninstall {{nightly|stable|latest|version_string|commit_hash}}
Uninstall the specified version of Neovim:
docker compose down
View Details ▼
docker compose down
Stop and remove containers, networks, images, and volumes created by `docker compose up`.
docker compose down
Stop and remove all containers and networks:
docker compose down --rmi all
Stop and remove containers, networks, and all images used by services:
docker compose down --rmi local
Stop and remove containers, networks, and only images without a custom tag:
docker compose logs
View Details ▼
docker compose logs
View output from containers in a Docker Compose application.
docker compose logs
View logs for all services:
docker compose logs {{service_name}}
View logs for a specific service:
docker compose logs {{[-f|--follow]}}
View logs and follow new output (like `tail --follow`):
docker compose up
View Details ▼
docker compose up
Start and run Docker services defined in a Compose file.
docker compose up
Start all services defined in the docker-compose file:
docker compose up {{[-d|--detach]}}
Start services in the background (detached mode):
docker compose up --build
Start services and rebuild images before starting:
docker compose
View Details ▼
docker compose
Run and manage multi container Docker applications.
docker compose ps
List all running containers:
docker compose up {{[-d|--detach]}}
Create and start all containers in the background using a `docker-compose.yml` file from the current directory:
docker compose up --build
Start all containers, rebuild if necessary:
git clone
View Details ▼
git clone
Clone an existing repository.
git clone {{remote_repository_location}} {{path/to/directory}}
Clone an existing repository into a new directory (the default directory is the repository name):
git clone --recursive {{remote_repository_location}}
Clone an existing repository and its submodules:
git clone {{[-n|--no-checkout]}} {{remote_repository_location}}
Clone only the `.git` directory of an existing repository:
pip install
View Details ▼
pip install
Install Python packages.
pip install {{package1 package2 ...}}
Install one or more packages:
pip install {{package1 package2 ...}} {{[-U|--upgrade]}}
Upgrade all specified packages to the latest version, installing any that are not already present:
pip install {{package}}=={{version}}
Install a specific version of a package:
python
View Details ▼
python
Python language interpreter.
python
Start a REPL (interactive shell):
python {{path/to/file.py}}
Execute a specific Python file:
python -i {{path/to/file.py}}
Execute a specific Python file and start a REPL: