11# Changelog
22
3- All notable changes to the ToonDB Python SDK will be documented in this file.
3+ All notable changes to the SochDB Python SDK will be documented in this file.
44
55The format is based on [ Keep a Changelog] ( https://keepachangelog.com/en/1.0.0/ ) ,
66and this project adheres to [ Semantic Versioning] ( https://semver.org/spec/v2.0.0.html ) .
@@ -15,11 +15,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1515## [ 0.3.2] - 2026-01-04
1616
1717### Repository Update
18- - 📦 ** Moved Python SDK** to its own repository: [ https://github.com/toondb/toondb -python-sdk ] ( https://github.com/toondb/toondb -python-sdk )
18+ - 📦 ** Moved Python SDK** to its own repository: [ https://github.com/sochdb/sochdb -python-sdk ] ( https://github.com/sochdb/sochdb -python-sdk )
1919- This allows for independent versioning and faster CI/CD pipelines.
2020
2121### Infrastructure
22- - ** New Release Workflow** : Now pulls pre-built binaries directly from [ toondb/toondb ] ( https://github.com/toondb/toondb ) releases.
22+ - ** New Release Workflow** : Now pulls pre-built binaries directly from [ sochdb/sochdb ] ( https://github.com/sochdb/sochdb ) releases.
2323 - Supports Python 3.9 through 3.13
2424 - Automatically creates GitHub releases with all wheel packages attached
2525 - Each wheel bundles platform-specific binaries and FFI libraries
@@ -31,7 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3131 - Windows x64
3232
3333### Documentation
34- - Added comprehensive [ RELEASE.md] ( RELEASE.md ) explaining how binaries are sourced from toondb/toondb
34+ - Added comprehensive [ RELEASE.md] ( RELEASE.md ) explaining how binaries are sourced from sochdb/sochdb
3535- Updated README with binary source information
3636- Enhanced release workflow with detailed summaries and status reporting
3737
@@ -41,29 +41,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
4141
4242#### Production-Grade CLI Tools
4343
44- CLI commands now available globally after ` pip install toondb -client ` :
44+ CLI commands now available globally after ` pip install sochdb -client ` :
4545
4646``` bash
47- toondb -server # IPC server for multi-process access
48- toondb -bulk # High-performance vector operations
49- toondb -grpc-server # gRPC server for remote vector search
47+ sochdb -server # IPC server for multi-process access
48+ sochdb -bulk # High-performance vector operations
49+ sochdb -grpc-server # gRPC server for remote vector search
5050```
5151
52- ** toondb -server features:**
52+ ** sochdb -server features:**
5353- ** Stale socket detection** - Auto-cleans orphaned socket files
5454- ** Health checks** - Waits for server ready before returning
5555- ** Graceful shutdown** - Handles SIGTERM/SIGINT/SIGHUP
5656- ** PID tracking** - Writes PID file for process management
5757- ** Permission checks** - Validates directory writable before starting
5858- ** stop/status commands** - Built-in process management
5959
60- ** toondb -bulk features:**
60+ ** sochdb -bulk features:**
6161- ** Input validation** - Checks file exists, readable, correct extension
6262- ** Output validation** - Checks directory writable, handles overwrites
6363- ** Progress reporting** - Shows file sizes during operations
6464- ** Structured subcommands** - build-index, query, info, convert
6565
66- ** toondb -grpc-server features:**
66+ ** sochdb -grpc-server features:**
6767- ** Port checking** - Verifies port available before binding
6868- ** Process detection** - Identifies what process is using a port
6969- ** Privileged port check** - Warns about ports < 1024 requiring root
@@ -83,9 +83,9 @@ toondb-grpc-server # gRPC server for remote vector search
8383
8484#### Environment Variable Overrides
8585
86- - ` TOONDB_SERVER_PATH ` - Override toondb -server binary path
87- - ` TOONDB_BULK_PATH ` - Override toondb -bulk binary path
88- - ` TOONDB_GRPC_SERVER_PATH ` - Override toondb -grpc-server binary path
86+ - ` SOCHDB_SERVER_PATH ` - Override sochdb -server binary path
87+ - ` SOCHDB_BULK_PATH ` - Override sochdb -bulk binary path
88+ - ` SOCHDB_GRPC_SERVER_PATH ` - Override sochdb -grpc-server binary path
8989
9090### Changed
9191
@@ -98,21 +98,21 @@ toondb-grpc-server # gRPC server for remote vector search
9898### Added
9999
100100#### Cross-Platform Binary Distribution
101- - ** Zero-compile installation** : Pre-built ` toondb -bulk` binaries bundled in wheels
101+ - ** Zero-compile installation** : Pre-built ` sochdb -bulk` binaries bundled in wheels
102102- ** Platform support matrix** :
103103 - ` manylinux_2_17_x86_64 ` - Linux x86_64 (glibc ≥ 2.17)
104104 - ` manylinux_2_17_aarch64 ` - Linux ARM64 (AWS Graviton, etc.)
105105 - ` macosx_11_0_universal2 ` - macOS Intel + Apple Silicon
106106 - ` win_amd64 ` - Windows x64
107107- ** Automatic binary resolution** with fallback chain:
108- 1 . Bundled in wheel (` _bin/<platform>/toondb -bulk ` )
109- 2 . System PATH (` which toondb -bulk ` )
108+ 1 . Bundled in wheel (` _bin/<platform>/sochdb -bulk ` )
109+ 2 . System PATH (` which sochdb -bulk ` )
110110 3 . Cargo target directory (development mode)
111111
112112#### Bulk API Enhancements
113113- ` bulk_query_index() ` - Query HNSW indexes for k nearest neighbors
114114- ` bulk_info() ` - Get index metadata (vector count, dimension, etc.)
115- - ` get_toondb_bulk_path ()` - Get resolved path to toondb -bulk binary
115+ - ` get_sochdb_bulk_path ()` - Get resolved path to sochdb -bulk binary
116116- ` _get_platform_tag() ` - Platform detection (linux-x86_64, darwin-aarch64, etc.)
117117- ` _find_bundled_binary() ` - Uses ` importlib.resources ` for installed packages
118118
@@ -130,7 +130,7 @@ toondb-grpc-server # gRPC server for remote vector search
130130
131131### Changed
132132
133- - Package renamed from ` toondb -client` to ` toondb `
133+ - Package renamed from ` sochdb -client` to ` sochdb `
134134- Wheel tags changed from ` any ` to platform-specific (` py3-none-<platform> ` )
135135- Binary resolution now uses ` importlib.resources ` instead of ` __file__ ` paths
136136
@@ -157,7 +157,7 @@ Follows the "uv-style" approach where:
157157### Added
158158
159159- Initial release
160- - Embedded mode with FFI access to ToonDB
160+ - Embedded mode with FFI access to SochDB
161161- IPC client mode for multi-process access
162162- Path-native API with O(|path|) lookups
163163- ACID transactions with snapshot isolation
@@ -173,6 +173,6 @@ Follows the "uv-style" approach where:
173173| Method | 768D Throughput | Notes |
174174| --------| -----------------| -------|
175175| Python FFI | ~ 130 vec/s | Direct FFI calls |
176- | Bulk API | ~ 1,600 vec/s | Subprocess to toondb -bulk |
176+ | Bulk API | ~ 1,600 vec/s | Subprocess to sochdb -bulk |
177177
178178FFI overhead eliminated by subprocess approach for bulk operations.
0 commit comments