axim-memory-sdk 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of axim-memory-sdk might be problematic. Click here for more details.

@@ -0,0 +1,284 @@
1
+ # This file is automatically @generated by Cargo.
2
+ # It is not intended for manual editing.
3
+ version = 3
4
+
5
+ [[package]]
6
+ name = "autocfg"
7
+ version = "1.5.1"
8
+ source = "registry+https://github.com/rust-lang/crates.io-index"
9
+ checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
10
+
11
+ [[package]]
12
+ name = "axim_memory_native"
13
+ version = "0.2.0"
14
+ dependencies = [
15
+ "pyo3",
16
+ "rand",
17
+ "rand_distr",
18
+ ]
19
+
20
+ [[package]]
21
+ name = "cfg-if"
22
+ version = "1.0.5"
23
+ source = "registry+https://github.com/rust-lang/crates.io-index"
24
+ checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
25
+
26
+ [[package]]
27
+ name = "getrandom"
28
+ version = "0.2.17"
29
+ source = "registry+https://github.com/rust-lang/crates.io-index"
30
+ checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
31
+ dependencies = [
32
+ "cfg-if",
33
+ "libc",
34
+ "wasi",
35
+ ]
36
+
37
+ [[package]]
38
+ name = "heck"
39
+ version = "0.5.0"
40
+ source = "registry+https://github.com/rust-lang/crates.io-index"
41
+ checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
42
+
43
+ [[package]]
44
+ name = "indoc"
45
+ version = "2.0.8"
46
+ source = "registry+https://github.com/rust-lang/crates.io-index"
47
+ checksum = "a37b2691796cffeb8a8cd305ac66e65841559f147f4e63231d0eafa4db5384d1"
48
+ dependencies = [
49
+ "rustversion",
50
+ ]
51
+
52
+ [[package]]
53
+ name = "libc"
54
+ version = "0.2.191"
55
+ source = "registry+https://github.com/rust-lang/crates.io-index"
56
+ checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
57
+
58
+ [[package]]
59
+ name = "libm"
60
+ version = "0.2.16"
61
+ source = "registry+https://github.com/rust-lang/crates.io-index"
62
+ checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
63
+
64
+ [[package]]
65
+ name = "memoffset"
66
+ version = "0.9.1"
67
+ source = "registry+https://github.com/rust-lang/crates.io-index"
68
+ checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
69
+ dependencies = [
70
+ "autocfg",
71
+ ]
72
+
73
+ [[package]]
74
+ name = "num-traits"
75
+ version = "0.2.19"
76
+ source = "registry+https://github.com/rust-lang/crates.io-index"
77
+ checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
78
+ dependencies = [
79
+ "autocfg",
80
+ "libm",
81
+ ]
82
+
83
+ [[package]]
84
+ name = "once_cell"
85
+ version = "1.21.4"
86
+ source = "registry+https://github.com/rust-lang/crates.io-index"
87
+ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
88
+
89
+ [[package]]
90
+ name = "portable-atomic"
91
+ version = "1.15.0"
92
+ source = "registry+https://github.com/rust-lang/crates.io-index"
93
+ checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
94
+
95
+ [[package]]
96
+ name = "ppv-lite86"
97
+ version = "0.2.21"
98
+ source = "registry+https://github.com/rust-lang/crates.io-index"
99
+ checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
100
+ dependencies = [
101
+ "zerocopy",
102
+ ]
103
+
104
+ [[package]]
105
+ name = "proc-macro2"
106
+ version = "1.0.107"
107
+ source = "registry+https://github.com/rust-lang/crates.io-index"
108
+ checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
109
+ dependencies = [
110
+ "unicode-ident",
111
+ ]
112
+
113
+ [[package]]
114
+ name = "pyo3"
115
+ version = "0.23.5"
116
+ source = "registry+https://github.com/rust-lang/crates.io-index"
117
+ checksum = "7778bffd85cf38175ac1f545509665d0b9b92a198ca7941f131f85f7a4f9a872"
118
+ dependencies = [
119
+ "cfg-if",
120
+ "indoc",
121
+ "libc",
122
+ "memoffset",
123
+ "once_cell",
124
+ "portable-atomic",
125
+ "pyo3-build-config",
126
+ "pyo3-ffi",
127
+ "pyo3-macros",
128
+ "unindent",
129
+ ]
130
+
131
+ [[package]]
132
+ name = "pyo3-build-config"
133
+ version = "0.23.5"
134
+ source = "registry+https://github.com/rust-lang/crates.io-index"
135
+ checksum = "94f6cbe86ef3bf18998d9df6e0f3fc1050a8c5efa409bf712e661a4366e010fb"
136
+ dependencies = [
137
+ "once_cell",
138
+ "target-lexicon",
139
+ ]
140
+
141
+ [[package]]
142
+ name = "pyo3-ffi"
143
+ version = "0.23.5"
144
+ source = "registry+https://github.com/rust-lang/crates.io-index"
145
+ checksum = "e9f1b4c431c0bb1c8fb0a338709859eed0d030ff6daa34368d3b152a63dfdd8d"
146
+ dependencies = [
147
+ "libc",
148
+ "pyo3-build-config",
149
+ ]
150
+
151
+ [[package]]
152
+ name = "pyo3-macros"
153
+ version = "0.23.5"
154
+ source = "registry+https://github.com/rust-lang/crates.io-index"
155
+ checksum = "fbc2201328f63c4710f68abdf653c89d8dbc2858b88c5d88b0ff38a75288a9da"
156
+ dependencies = [
157
+ "proc-macro2",
158
+ "pyo3-macros-backend",
159
+ "quote",
160
+ "syn",
161
+ ]
162
+
163
+ [[package]]
164
+ name = "pyo3-macros-backend"
165
+ version = "0.23.5"
166
+ source = "registry+https://github.com/rust-lang/crates.io-index"
167
+ checksum = "fca6726ad0f3da9c9de093d6f116a93c1a38e417ed73bf138472cf4064f72028"
168
+ dependencies = [
169
+ "heck",
170
+ "proc-macro2",
171
+ "pyo3-build-config",
172
+ "quote",
173
+ "syn",
174
+ ]
175
+
176
+ [[package]]
177
+ name = "quote"
178
+ version = "1.0.47"
179
+ source = "registry+https://github.com/rust-lang/crates.io-index"
180
+ checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
181
+ dependencies = [
182
+ "proc-macro2",
183
+ ]
184
+
185
+ [[package]]
186
+ name = "rand"
187
+ version = "0.8.8"
188
+ source = "registry+https://github.com/rust-lang/crates.io-index"
189
+ checksum = "e058c7de0b26af77780c769414d6257830bb240f3c38477dbc2c16e5f54d6d4c"
190
+ dependencies = [
191
+ "libc",
192
+ "rand_chacha",
193
+ "rand_core",
194
+ ]
195
+
196
+ [[package]]
197
+ name = "rand_chacha"
198
+ version = "0.3.1"
199
+ source = "registry+https://github.com/rust-lang/crates.io-index"
200
+ checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
201
+ dependencies = [
202
+ "ppv-lite86",
203
+ "rand_core",
204
+ ]
205
+
206
+ [[package]]
207
+ name = "rand_core"
208
+ version = "0.6.4"
209
+ source = "registry+https://github.com/rust-lang/crates.io-index"
210
+ checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
211
+ dependencies = [
212
+ "getrandom",
213
+ ]
214
+
215
+ [[package]]
216
+ name = "rand_distr"
217
+ version = "0.4.3"
218
+ source = "registry+https://github.com/rust-lang/crates.io-index"
219
+ checksum = "32cb0b9bc82b0a0876c2dd994a7e7a2683d3e7390ca40e6886785ef0c7e3ee31"
220
+ dependencies = [
221
+ "num-traits",
222
+ "rand",
223
+ ]
224
+
225
+ [[package]]
226
+ name = "rustversion"
227
+ version = "1.0.23"
228
+ source = "registry+https://github.com/rust-lang/crates.io-index"
229
+ checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
230
+
231
+ [[package]]
232
+ name = "syn"
233
+ version = "2.0.119"
234
+ source = "registry+https://github.com/rust-lang/crates.io-index"
235
+ checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
236
+ dependencies = [
237
+ "proc-macro2",
238
+ "quote",
239
+ "unicode-ident",
240
+ ]
241
+
242
+ [[package]]
243
+ name = "target-lexicon"
244
+ version = "0.12.16"
245
+ source = "registry+https://github.com/rust-lang/crates.io-index"
246
+ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
247
+
248
+ [[package]]
249
+ name = "unicode-ident"
250
+ version = "1.0.27"
251
+ source = "registry+https://github.com/rust-lang/crates.io-index"
252
+ checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
253
+
254
+ [[package]]
255
+ name = "unindent"
256
+ version = "0.2.4"
257
+ source = "registry+https://github.com/rust-lang/crates.io-index"
258
+ checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
259
+
260
+ [[package]]
261
+ name = "wasi"
262
+ version = "0.11.1+wasi-snapshot-preview1"
263
+ source = "registry+https://github.com/rust-lang/crates.io-index"
264
+ checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
265
+
266
+ [[package]]
267
+ name = "zerocopy"
268
+ version = "0.8.63"
269
+ source = "registry+https://github.com/rust-lang/crates.io-index"
270
+ checksum = "e5fe1f8f1b06191a00962174c61aa5005e0bb391a6d80d07e24d115c01a92ed8"
271
+ dependencies = [
272
+ "zerocopy-derive",
273
+ ]
274
+
275
+ [[package]]
276
+ name = "zerocopy-derive"
277
+ version = "0.8.63"
278
+ source = "registry+https://github.com/rust-lang/crates.io-index"
279
+ checksum = "863ad3ac83293fb4d740aedbfdc9240dd8d1a50c1099acd76ce80ce7c7230c7f"
280
+ dependencies = [
281
+ "proc-macro2",
282
+ "quote",
283
+ "syn",
284
+ ]
@@ -0,0 +1,32 @@
1
+ [package]
2
+ name = "axim_memory_native"
3
+ version = "0.2.0"
4
+ edition = "2021"
5
+ rust-version = "1.70"
6
+ description = "High-performance native Rust core for Axim Memory SDK with TurboQuant quantization"
7
+ license = "Proprietary"
8
+ readme = "README.md"
9
+
10
+ [lib]
11
+ name = "_native"
12
+ crate-type = ["cdylib", "rlib"]
13
+
14
+ [dependencies]
15
+ pyo3 = { version = "0.23", features = ["extension-module"], optional = true }
16
+ rand = "0.8"
17
+ rand_distr = "0.4"
18
+
19
+ [features]
20
+ default = []
21
+ python = ["pyo3"]
22
+
23
+ # ══════════════════════════════════════════════════════════════
24
+ # Anti-Reverse-Engineering & Binary Stripping Profile
25
+ # ══════════════════════════════════════════════════════════════
26
+ [profile.release]
27
+ opt-level = 3 # Maximum compiler optimizations
28
+ lto = "fat" # Fat Link-Time Optimization (cross-boundary inlining & mangling)
29
+ codegen-units = 1 # Single unit maximizes dead-code stripping and algorithmic inlining
30
+ panic = "abort" # Eliminates panic formatting strings, line numbers, and file paths
31
+ strip = true # Strips all symbol tables, function names, and debug info
32
+ overflow-checks = false
@@ -0,0 +1,132 @@
1
+ COGNITUS LAB PROPRIETARY END USER LICENSE AGREEMENT (EULA)
2
+ ================================================================================
3
+ AXIM MEMORY SDK™ — Universal AI Memory & Quantization Engine
4
+ Copyright (c) 2026 Cognitus Lab. All Rights Reserved.
5
+ ================================================================================
6
+
7
+ IMPORTANT — READ CAREFULLY BEFORE DOWNLOADING, INSTALLING, COPYING, OR USING:
8
+ This End User License Agreement ("Agreement" or "EULA") is a legally binding contract
9
+ between you (either an individual or a single legal entity, hereinafter "Licensee" or
10
+ "You") and Cognitus Lab ("Licensor", "Cognitus", "We", or "Us").
11
+
12
+ BY DOWNLOADING, INSTALLING, COPYING, OR OTHERWISE USING AXIM MEMORY SDK (INCLUDING
13
+ ITS COMPILED PACKAGES, PYTHON MODULES, INTERFACES, DATA STRUCTURES, EMBEDDING ENGINES,
14
+ AND RUNTIME ARTIFACTS), YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT.
15
+ IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT DOWNLOAD, INSTALL,
16
+ OR USE AXIM MEMORY SDK.
17
+
18
+ ================================================================================
19
+ 1. 100% COGNITUS LAB PROPRIETARY OWNERSHIP
20
+ ================================================================================
21
+ Axim Memory SDK, including all software modules (axim_memory, client, store,
22
+ turboquant), extreme compression algorithms, 1-bit / 2-bit quantization routines,
23
+ Hamming distance space projection methods, cosine clustering structures, dual-tier
24
+ memory architectures, and documentation, are the sole and exclusive property of
25
+ Cognitus Lab.
26
+
27
+ This software is licensed, NOT sold. Cognitus Lab retains all right, title,
28
+ ownership, and interest in and to Axim Memory SDK, including all worldwide intellectual
29
+ property rights, patents, patent applications, copyrights, trade secrets, moral
30
+ rights, trademarks, and proprietary technical know-how.
31
+
32
+ No ownership rights or intellectual property rights are transferred to You.
33
+ All rights not expressly granted in Section 2 are strictly reserved by Cognitus Lab.
34
+
35
+ ================================================================================
36
+ 2. GRANT OF LIMITED USE LICENSE (EXECUTION ONLY)
37
+ ================================================================================
38
+ Conditioned upon Your continuous compliance with all terms of this Agreement,
39
+ Cognitus Lab grants You a personal, non-exclusive, non-transferable, non-sublicensable,
40
+ revocable, limited license solely to:
41
+
42
+ (a) Download and install compiled packages of Axim Memory SDK on Your personal
43
+ computers, workstations, servers, or cloud virtual machines;
44
+ (b) Execute and run Axim Memory SDK modules exclusively as an AI memory and vector
45
+ retrieval SDK to power Your AI agents, LLM pipelines, and applications (in
46
+ the identical manner in which a proprietary runtime or SDK is utilized by
47
+ developers to execute workloads on user infrastructure).
48
+
49
+ ================================================================================
50
+ 3. STRICT RESTRICTIONS — NO COPYING, NO RESELLING, NO REDISTRIBUTION
51
+ ================================================================================
52
+ You explicitly agree that You shall NOT, directly or indirectly:
53
+
54
+ (a) NO RESALE OR COMMERCIALIZATION: You shall not sell, resell, lease, rent,
55
+ loan, license, sublicense, monetize, distribute, or transfer copies of
56
+ Axim Memory SDK or any of its component modules to any third party;
57
+ (b) NO COPYING OR MIRRORING: You shall not copy, duplicate, replicate, mirror,
58
+ or publicly host Axim Memory SDK packages, wheels, or source trees on any
59
+ third-party server, repository, or distribution network without express
60
+ prior written consent from Cognitus Lab;
61
+ (c) NO DERIVATIVE MONETIZATION: You shall not package, bundle, or redistribute
62
+ Axim Memory SDK into standalone commercial memory databases or competing
63
+ vector retrieval SDKs for sale.
64
+
65
+ ================================================================================
66
+ 4. ANTI-REVERSE ENGINEERING, ANTI-DECOMPILATION, & IP PROTECTION
67
+ ================================================================================
68
+ Axim Memory SDK contains valuable trade secrets, confidential algorithmic structures,
69
+ and proprietary mathematical representations belonging to Cognitus Lab.
70
+
71
+ You strictly agree that You shall NOT, and shall not assist, permit, or cause
72
+ any employee, contractor, agent, or third party to:
73
+
74
+ (a) Reverse engineer, decompile, disassemble, translate, decipher, probe,
75
+ or attempt to derive proprietary trade secrets, internal logic, or hidden
76
+ algorithms of Axim Memory SDK;
77
+ (b) Extract, reconstruct, or isolate mathematical transforms, TurboQuant compression
78
+ matrices, quantization formulas, or state tables embedded within the software;
79
+ (c) Circumvent, disable, bypass, or defeat any integrity verification, digital
80
+ signature, or anti-tamper mechanisms;
81
+ (d) Modify, patch, adapt, create derivative works of, or build competing vector
82
+ compression or agent memory frameworks based on Axim Memory SDK routines.
83
+
84
+ ================================================================================
85
+ 5. UPDATES AND INTEGRITY VERIFICATION
86
+ ================================================================================
87
+ Cognitus Lab may, from time to time, issue security patches, compatibility updates,
88
+ and performance improvements. Cognitus Lab reserves the right to incorporate integrity
89
+ verification mechanisms to ensure that the SDK executing within Your environment
90
+ has not been tampered with or altered.
91
+
92
+ ================================================================================
93
+ 6. TERMINATION
94
+ ================================================================================
95
+ This Agreement is effective from the date You first download, install, or use
96
+ Axim Memory SDK and shall remain in effect until terminated. Your rights under this
97
+ Agreement will terminate automatically and immediately without notice from
98
+ Cognitus Lab if You fail to comply with any provision of this Agreement.
99
+ Upon termination, You must immediately cease all use of Axim Memory SDK and
100
+ permanently destroy all copies of Axim Memory SDK in Your possession or control.
101
+
102
+ ================================================================================
103
+ 7. DISCLAIMER OF WARRANTIES
104
+ ================================================================================
105
+ AXIM MEMORY SDK IS PROVIDED "AS IS", WITH ALL FAULTS AND WITHOUT WARRANTY OF ANY
106
+ KIND. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, COGNITUS LAB DISCLAIMS
107
+ ALL WARRANTIES AND CONDITIONS, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING
108
+ BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
109
+ PARTICULAR PURPOSE, TITLE, ACCURACY, AND NON-INFRINGEMENT.
110
+
111
+ ================================================================================
112
+ 8. LIMITATION OF LIABILITY
113
+ ================================================================================
114
+ IN NO EVENT SHALL COGNITUS LAB, ITS DIRECTORS, EMPLOYEES, AFFILIATES, OR LICENSORS
115
+ BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, PUNITIVE, OR CONSEQUENTIAL DAMAGES
116
+ WHATSOEVER (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION,
117
+ LOSS OF DATA, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY
118
+ TO USE AXIM MEMORY SDK, EVEN IF COGNITUS LAB HAS BEEN ADVISED OF THE POSSIBILITY
119
+ OF SUCH DAMAGES.
120
+
121
+ ================================================================================
122
+ 9. GOVERNING LAW & JURISDICTION
123
+ ================================================================================
124
+ This Agreement shall be governed by and construed in accordance with the laws
125
+ applicable to proprietary software licensing, without regard to conflict of law
126
+ principles. The United Nations Convention on Contracts for the International
127
+ Sale of Goods shall not apply.
128
+
129
+ ================================================================================
130
+ For licensing inquiries, enterprise deployments, or OEM integrations, contact:
131
+ Cognitus Lab — https://github.com/Cognitus-Lab
132
+ ================================================================================
@@ -0,0 +1,119 @@
1
+ Metadata-Version: 2.4
2
+ Name: axim-memory-sdk
3
+ Version: 0.2.0
4
+ Classifier: Development Status :: 4 - Beta
5
+ Classifier: Intended Audience :: Developers
6
+ Classifier: License :: Other/Proprietary License
7
+ Classifier: Operating System :: MacOS :: MacOS X
8
+ Classifier: Operating System :: POSIX :: Linux
9
+ Classifier: Operating System :: Microsoft :: Windows
10
+ Classifier: Programming Language :: Python :: 3
11
+ Classifier: Programming Language :: Python :: 3.9
12
+ Classifier: Programming Language :: Python :: 3.10
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: 3.13
16
+ Classifier: Programming Language :: Rust
17
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
18
+ License-File: LICENSE
19
+ Summary: Axim Memory SDK: Dual-layer AI memory and extreme vector compression engine for autonomous agents by Cognitus Lab.
20
+ Keywords: ai,agents,memory,embeddings,vector-store,quantization,axim,sdk,turboquant
21
+ Author: Cognitus Lab
22
+ License: Proprietary: Cognitus Lab End User License Agreement (EULA)
23
+ Requires-Python: >=3.9
24
+ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
25
+ Project-URL: Homepage, https://github.com/Cognitus-Lab/Axim-Memory-SDK
26
+ Project-URL: Issues, https://github.com/Cognitus-Lab/Axim-Memory-SDK/issues
27
+ Project-URL: Repository, https://github.com/Cognitus-Lab/Axim-Memory-SDK
28
+
29
+ # Axim Memory SDK
30
+
31
+ [![PyPI Version](https://img.shields.io/pypi/v/axim-memory-sdk.svg)](https://pypi.org/project/axim-memory-sdk/)
32
+ [![Python Versions](https://img.shields.io/pypi/pyversions/axim-memory-sdk.svg)](https://pypi.org/project/axim-memory-sdk/)
33
+ [![License: Proprietary](https://img.shields.io/badge/License-Cognitus%20Proprietary-red.svg)](./LICENSE)
34
+
35
+ **Axim Memory SDK™** is a high-performance, dual-layer AI memory and vector retrieval SDK engineered by **Cognitus Lab**. Designed specifically for autonomous AI agents, multi-agent frameworks, and conversational pipelines, it provides instantaneous context recall and persistent local vector storage with zero runtime dependencies.
36
+
37
+ ---
38
+
39
+ > ### ⚠️ Proprietary Notice & License Terms
40
+ > **Axim Memory SDK™ is 100% Cognitus Lab Property.**
41
+ > This software is licensed for execution only under the terms of the **Cognitus Lab Proprietary End User License Agreement (EULA)**.
42
+ > - **No Copying or Reselling:** You may not copy, mirror, resell, lease, sublicense, or commercially redistribute this SDK or its component packages.
43
+ > - **Anti-Reverse Engineering:** Reverse engineering, decompilation, disassembly, algorithmic derivation, or unauthorized extraction of internal data structures is strictly prohibited.
44
+ > - See the full [LICENSE](./LICENSE) for legal terms and conditions.
45
+
46
+ ---
47
+
48
+ ## Key Features
49
+
50
+ - **⚡ Instant Dual-Layer Architecture:** Combines an ultra-fast in-memory cache for low-latency context matching with atomic, crash-resilient local persistence.
51
+ - **🛡️ Strict User Isolation:** Multi-tenant memory management ensures that queries and stored memories are strictly isolated by `user_id`.
52
+ - **📦 Zero External Runtime Dependencies:** Engineered with zero third-party runtime package requirements, minimizing supply-chain exposure and eliminating dependency conflicts.
53
+ - **🔌 Model-Agnostic Integration:** Compatible with any embedding provider (Mistral, OpenAI, Ollama, Cohere, HuggingFace, or custom local embedding models).
54
+ - **📝 Automated Prompt Context Synthesis:** Instantly compiles relevant user history into markdown blocks formatted for LLM system prompts.
55
+
56
+ ---
57
+
58
+ ## Installation
59
+
60
+ Install the official package directly from PyPI:
61
+
62
+ ```bash
63
+ pip install axim-memory-sdk
64
+ ```
65
+
66
+ ---
67
+
68
+ ## Quick Start
69
+
70
+ The SDK is completely model-agnostic. Provide any embedding function that accepts a text string and returns a vector list of floating-point numbers:
71
+
72
+ ```python
73
+ from axim_memory import MultiLayerMemory
74
+
75
+ # 1. Define your embedding provider (e.g., OpenAI, Ollama, or custom embedding)
76
+ def get_embedding(text: str):
77
+ # Call your embedding model API or local pipeline
78
+ return [0.1, 0.4, -0.2, 0.9] * 256 # 1024-dimension vector
79
+
80
+ # 2. Initialize the dual-layer memory engine
81
+ memory = MultiLayerMemory(
82
+ embedding_fn=get_embedding,
83
+ storage_path="~/.axim_memory.json",
84
+ original_dim=1024,
85
+ target_dim=128,
86
+ )
87
+
88
+ # 3. Store a memory for a user
89
+ memory.add("User prefers dark mode and concise code responses", user_id="user_123")
90
+
91
+ # 4. Search relevant user context
92
+ results = memory.search("editor preferences", user_id="user_123", limit=3)
93
+ print("Search results:", results)
94
+
95
+ # 5. Generate formatted context for an LLM prompt
96
+ prompt_context = memory.get_context_string("What theme does the user like?", user_id="user_123")
97
+ print(prompt_context)
98
+ ```
99
+
100
+ ---
101
+
102
+ ## API Reference
103
+
104
+ ### `MultiLayerMemory`
105
+
106
+ | Method | Parameters | Description |
107
+ |---|---|---|
108
+ | `add(text, user_id="default", metadata=None)` | `text: str`, `user_id: str`, `metadata: dict` | Records memories into both the fast cache and persistent store. |
109
+ | `search(query, user_id="default", limit=5, threshold=0.0)` | `query: str`, `user_id: str`, `limit: int`, `threshold: float` | Performs dual-tier similarity matching, returning ranked memories. |
110
+ | `get_context_string(query, user_id="default", limit=5, threshold=0.0)` | `query: str`, `user_id: str`, `limit: int`, `threshold: float` | Generates a Markdown context block ready for LLM prompt injection. |
111
+
112
+ ---
113
+
114
+ ## Support & Enterprise Licensing
115
+
116
+ For enterprise licensing inquiries, custom OEM runtime integration, or support:
117
+ - **Organization:** Cognitus Lab
118
+ - **Repository:** [https://github.com/Cognitus-Lab/Axim-Memory-SDK](https://github.com/Cognitus-Lab/Axim-Memory-SDK)
119
+
@@ -0,0 +1,110 @@
1
+ # Axim Memory SDK
2
+
3
+ [![PyPI Version](https://img.shields.io/pypi/v/axim-memory-sdk.svg)](https://pypi.org/project/axim-memory-sdk/)
4
+ [![Python Versions](https://img.shields.io/pypi/pyversions/axim-memory-sdk.svg)](https://pypi.org/project/axim-memory-sdk/)
5
+ [![Security Pipeline](https://github.com/Cognitus-Lab/Axim-Memory-SDK/actions/workflows/security.yml/badge.svg)](https://github.com/Cognitus-Lab/Axim-Memory-SDK/actions/workflows/security.yml)
6
+ [![License: Proprietary](https://img.shields.io/badge/License-Cognitus%20Proprietary-red.svg)](./LICENSE)
7
+
8
+ **Axim Memory SDK™** is a high-performance, dual-layer AI memory and vector retrieval SDK engineered by **Cognitus Lab**. Designed specifically for autonomous AI agents, multi-agent frameworks, and conversational pipelines, it provides instantaneous context recall and persistent local vector storage with zero runtime dependencies.
9
+
10
+ ---
11
+
12
+ > ### ⚠️ Proprietary Notice & License Terms
13
+ > **Axim Memory SDK™ is 100% Cognitus Lab Property.**
14
+ > This software is licensed for execution only under the terms of the **Cognitus Lab Proprietary End User License Agreement (EULA)**.
15
+ > - **No Copying or Reselling:** You may not copy, mirror, resell, lease, sublicense, or commercially redistribute this SDK or its component packages.
16
+ > - **Anti-Reverse Engineering:** Reverse engineering, decompilation, disassembly, algorithmic derivation, or unauthorized extraction of internal data structures is strictly prohibited.
17
+ > - See the full [LICENSE](./LICENSE) for legal terms and conditions.
18
+
19
+ ---
20
+
21
+ ## Key Features
22
+
23
+ - **⚡ Instant Dual-Layer Architecture:** Combines an ultra-fast in-memory cache for low-latency context matching with atomic, crash-resilient local persistence.
24
+ - **🛡️ Strict User Isolation:** Multi-tenant memory management ensures that queries and stored memories are strictly isolated by `user_id`.
25
+ - **📦 Zero External Runtime Dependencies:** Engineered with zero third-party runtime package requirements, minimizing supply-chain exposure and eliminating dependency conflicts.
26
+ - **🔌 Model-Agnostic Integration:** Compatible with any embedding provider (Mistral, OpenAI, Ollama, Cohere, HuggingFace, or custom local embedding models).
27
+ - **📝 Automated Prompt Context Synthesis:** Instantly compiles relevant user history into markdown blocks formatted for LLM system prompts.
28
+
29
+ ---
30
+
31
+ ## Installation
32
+
33
+ ### From PyPI (recommended)
34
+
35
+ ```bash
36
+ pip install axim-memory-sdk
37
+ ```
38
+
39
+ ### From Local Source
40
+
41
+ ```bash
42
+ git clone https://github.com/Cognitus-Lab/Axim-Memory-SDK.git
43
+ cd Axim-Memory-SDK
44
+ pip install .
45
+ ```
46
+
47
+ ---
48
+
49
+ ## Quick Start
50
+
51
+ The SDK is completely model-agnostic. Provide any embedding function that accepts a text string and returns a vector list of floating-point numbers:
52
+
53
+ ```python
54
+ from axim_memory import MultiLayerMemory
55
+
56
+ # 1. Define your embedding provider (e.g., OpenAI, Ollama, or custom embedding)
57
+ def get_embedding(text: str):
58
+ # Call your embedding model API or local pipeline
59
+ return [0.1, 0.4, -0.2, 0.9] * 256 # 1024-dimension vector
60
+
61
+ # 2. Initialize the dual-layer memory engine
62
+ memory = MultiLayerMemory(
63
+ embedding_fn=get_embedding,
64
+ storage_path="~/.axim_memory.json",
65
+ original_dim=1024,
66
+ target_dim=128,
67
+ )
68
+
69
+ # 3. Store a memory for a user
70
+ memory.add("User prefers dark mode and concise code responses", user_id="user_123")
71
+
72
+ # 4. Search relevant user context
73
+ results = memory.search("editor preferences", user_id="user_123", limit=3)
74
+ print("Search results:", results)
75
+
76
+ # 5. Generate formatted context for an LLM prompt
77
+ prompt_context = memory.get_context_string("What theme does the user like?", user_id="user_123")
78
+ print(prompt_context)
79
+ ```
80
+
81
+ ---
82
+
83
+ ## API Reference
84
+
85
+ ### `MultiLayerMemory`
86
+
87
+ | Method | Parameters | Description |
88
+ |---|---|---|
89
+ | `add(text, user_id="default", metadata=None)` | `text: str`, `user_id: str`, `metadata: dict` | Records memories into both the fast cache and persistent store. |
90
+ | `search(query, user_id="default", limit=5, threshold=0.0)` | `query: str`, `user_id: str`, `limit: int`, `threshold: float` | Performs dual-tier similarity matching, returning ranked memories. |
91
+ | `get_context_string(query, user_id="default", limit=5, threshold=0.0)` | `query: str`, `user_id: str`, `limit: int`, `threshold: float` | Generates a Markdown context block ready for LLM prompt injection. |
92
+
93
+ ---
94
+
95
+ ## Security Architecture
96
+
97
+ Axim Memory SDK is engineered with a strict defense-in-depth posture:
98
+ - **Zero Third-Party Runtime Dependencies:** Eliminates runtime dependency supply-chain risks.
99
+ - **Atomic File Operations:** Uses atomic write-and-replace routines to prevent database corruption during sudden process termination.
100
+ - **Path Sanitization:** Enforces expanded real-path validation on all local storage directories to eliminate path traversal vulnerabilities.
101
+ - **Automated CI Hardening:** Continuous static AST analysis (Bandit), supply chain dependency auditing, and semantic analysis (CodeQL) run on all commits.
102
+
103
+ ---
104
+
105
+ ## Support & Enterprise Licensing
106
+
107
+ For enterprise licensing inquiries, custom OEM runtime integration, or support:
108
+ - **Organization:** Cognitus Lab
109
+ - **Repository:** [https://github.com/Cognitus-Lab/Axim-Memory-SDK](https://github.com/Cognitus-Lab/Axim-Memory-SDK)
110
+ - **License:** 100% Cognitus Lab Property (EULA) — See [LICENSE](./LICENSE).