1.2.1

Zielon/INSTA1.2.1Nov 23, 2025by nullure

AI Summary

A major SDK overhaul for both Python and JavaScript, transforming them into standalone versions with full feature parity, SQLite backend support, and multi-sector memory capabilities.

Key Highlights

SDK Overhaul: Python and JS SDKs now standalone with SQLite backend
Full feature parity with the Backend
Support for 5 cognitive sectors (episodic, semantic, etc.)
Comprehensive test suites and rewritten examples

New Features

Support for all embedding providers (synthetic, OpenAI, Gemini, etc.)
Advanced features: decay, compression, reflection
Architecture documentation with Mermaid diagrams
Node.js script for diagram regeneration

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