Skip to content

docs: fix PACKAGE_USAGE.md to match current public API#73

Open
FBISiri wants to merge 1 commit into
aiming-lab:mainfrom
FBISiri:docs/fix-package-usage-api
Open

docs: fix PACKAGE_USAGE.md to match current public API#73
FBISiri wants to merge 1 commit into
aiming-lab:mainfrom
FBISiri:docs/fix-package-usage-api

Conversation

@FBISiri

@FBISiri FBISiri commented Jul 16, 2026

Copy link
Copy Markdown

What

docs/PACKAGE_USAGE.md documented a public API that no longer exists. Every code sample imported SimpleMemSystem, SimpleMemConfig, set_config, create_system, Dialogue and MemoryEntry straight from the top-level simplemem package, but the package now exports only:

__all__ = ["SimpleMem", "create", "list_modes", "optimize", "Config", "load_config"]

So the guide first example (from simplemem import SimpleMemSystem) raises ImportError, and the SimpleMemConfig / set_config configuration pattern is gone entirely.

The Environment Variables section also listed variables the package never reads (SIMPLEMEM_MODEL, SIMPLEMEM_EMBEDDING_MODEL, SIMPLEMEM_DB_PATH). The settings loader (simplemem/core/settings.py) actually resolves LLM_MODEL, EMBEDDING_MODEL and LANCEDB_PATH.

Changes

  • Rewrite all snippets to the current API: SimpleMem() (auto mode) and create(mode="text"|"omni", ...).
  • Replace the removed SimpleMemConfig / set_config section with the real configuration model (constructor kwargs, config.py, env vars) and document the resolution order.
  • Fix the environment-variable table to the names actually honored by settings.py.
  • Point Dialogue / MemoryEntry imports at simplemem.core.models.memory_entry.
  • Keep the optimized-retrieval flow (optimize -> Config -> load_config) consistent with the README.

Docs-only; no code changes.

The package usage guide referenced a removed public API. The examples
imported SimpleMemSystem, SimpleMemConfig, set_config, create_system,
Dialogue and MemoryEntry directly from the top-level simplemem package,
but simplemem.__all__ now only exports SimpleMem, create, list_modes,
optimize, Config and load_config. Following the first example verbatim
raised ImportError.

Update all snippets to the current API (SimpleMem / create(mode=...)),
correct the environment-variable names (LLM_MODEL, EMBEDDING_MODEL,
LANCEDB_PATH instead of the non-existent SIMPLEMEM_* variants), point
the data-model imports at simplemem.core.models.memory_entry, and note
the config.py / env-var resolution order.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant