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.
- axim_memory_sdk-0.2.0/Cargo.lock +284 -0
- axim_memory_sdk-0.2.0/Cargo.toml +32 -0
- axim_memory_sdk-0.2.0/LICENSE +132 -0
- axim_memory_sdk-0.2.0/PKG-INFO +119 -0
- axim_memory_sdk-0.2.0/README.md +110 -0
- axim_memory_sdk-0.2.0/README_PYPI.md +90 -0
- axim_memory_sdk-0.2.0/axim_memory/__init__.py +16 -0
- axim_memory_sdk-0.2.0/axim_memory/agent.py +188 -0
- axim_memory_sdk-0.2.0/axim_memory/client.py +113 -0
- axim_memory_sdk-0.2.0/axim_memory/store.py +103 -0
- axim_memory_sdk-0.2.0/axim_memory/turboquant.py +113 -0
- axim_memory_sdk-0.2.0/axim_memory_sdk.egg-info/PKG-INFO +246 -0
- axim_memory_sdk-0.2.0/axim_memory_sdk.egg-info/SOURCES.txt +14 -0
- axim_memory_sdk-0.2.0/axim_memory_sdk.egg-info/dependency_links.txt +1 -0
- axim_memory_sdk-0.2.0/axim_memory_sdk.egg-info/top_level.txt +1 -0
- axim_memory_sdk-0.2.0/dist/axim_memory_sdk-0.2.0-py3-none-any.whl +0 -0
- axim_memory_sdk-0.2.0/dist/axim_memory_sdk-0.2.0.tar.gz +0 -0
- axim_memory_sdk-0.2.0/pyproject.toml +40 -0
- axim_memory_sdk-0.2.0/src/lib.rs +223 -0
- axim_memory_sdk-0.2.0/tests/test_agent.py +59 -0
- axim_memory_sdk-0.2.0/tests/test_store_and_client.py +61 -0
- axim_memory_sdk-0.2.0/tests/test_turboquant.py +36 -0
|
@@ -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
|
+
[](https://pypi.org/project/axim-memory-sdk/)
|
|
32
|
+
[](https://pypi.org/project/axim-memory-sdk/)
|
|
33
|
+
[](./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
|
+
[](https://pypi.org/project/axim-memory-sdk/)
|
|
4
|
+
[](https://pypi.org/project/axim-memory-sdk/)
|
|
5
|
+
[](https://github.com/Cognitus-Lab/Axim-Memory-SDK/actions/workflows/security.yml)
|
|
6
|
+
[](./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).
|