1.2.1

stalwartlabs/stalwart1.2.1Nov 23, 2025by nullure

AI Summary

Introduces standalone Python and JavaScript SDKs that provide full feature parity with the backend, supporting multi-sector memory and advanced cognitive features like decay and reflection.

Key Highlights

  • Standalone Python and JavaScript SDKs with full backend feature parity
  • Local-first architecture with SQLite backend in SDKs
  • Support for multiple embedding providers (synthetic, OpenAI, etc.)
  • Comprehensive test suites and rewritten examples
  • New architecture documentation with Mermaid diagrams

New Features

  • Standalone Python SDK
  • Standalone JavaScript SDK
  • Rewritten Examples
  • Comprehensive Test Suites
  • Architecture Documentation

Full Release Notes

## 1.2.1 - Standalone Sdk

### Added

- **Python SDK (`sdk-py/`)**: SDK Overhaul, it can now perform as a standalone version of OpenMemory
  - Full feature parity with Backend
  - Local-first architecture with SQLite backend
  - Multi-sector memory (episodic, semantic, procedural, emotional, reflective)
  - All embedding providers: synthetic, OpenAI, Gemini, Ollama, AWS
  - Advanced features: decay, compression, reflection
  - Comprehensive test suite (`sdk-py/tests/test_sdk_py.py`)

- **JavaScript SDK Enhancements (`sdk-js/`)**: SDK Overhaul, it can now perform as a standalone version of OpenMemory
  - Full feature parity with Backend
  - Local-first architecture with SQLite backend
  - Multi-sector memory (episodic, semantic, procedural, emotional, reflective)
  - All embedding providers: synthetic, OpenAI, Gemini, Ollama, AWS
  - Advanced features: decay, compression, reflection

- **Examples**: Complete rewrite of both JS and Python examples
  - `examples/js-sdk/basic-usage.js` - CRUD operations
  - `examples/js-sdk/advanced-features.js` - Decay, compression, reflection
  - `examples/js-sdk/brain-sectors.js` - Multi-sector demonstration
  - `examples/py-sdk/basic_usage.py` - Python CRUD operations
  - `examples/py-sdk/advanced_features.py` - Advanced configuration
  - `examples/py-sdk/brain_sectors.py` - Sector demonstration
  - `examples/py-sdk/performance_benchmark.py` - Performance testing

- **Tests**: Comprehensive test suites for both SDKs
  - `tests/js-sdk/js-sdk.test.js` - Full SDK validation
  - `tests/py-sdk/test-sdk.py` - Python SDK validation
  - Tests cover: initialisation, CRUD, sectors, advanced features

- **Architecture Documentation**
  - Mermaid diagram in main README showing complete data flow
  - Covers all 5 cognitive sectors
  - Shows embedding engine, storage layer, and recall engine
  - Includes temporal knowledge graph integration
  - Node.js script to regenerate diagrams