catalyst-brain 0.1.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.
- catalyst_brain-0.1.0/Cargo.toml +37 -0
- catalyst_brain-0.1.0/MANIFEST.in +5 -0
- catalyst_brain-0.1.0/PKG-INFO +67 -0
- catalyst_brain-0.1.0/README.md +49 -0
- catalyst_brain-0.1.0/catalyst_brain.egg-info/PKG-INFO +67 -0
- catalyst_brain-0.1.0/catalyst_brain.egg-info/SOURCES.txt +29 -0
- catalyst_brain-0.1.0/catalyst_brain.egg-info/dependency_links.txt +1 -0
- catalyst_brain-0.1.0/catalyst_brain.egg-info/requires.txt +7 -0
- catalyst_brain-0.1.0/catalyst_brain.egg-info/top_level.txt +5 -0
- catalyst_brain-0.1.0/catalyst_brain_api.py +1003 -0
- catalyst_brain-0.1.0/catalyst_metacognition.py +575 -0
- catalyst_brain-0.1.0/hkvc_graphics/Cargo.toml +18 -0
- catalyst_brain-0.1.0/hkvc_graphics/src/bvh.rs +367 -0
- catalyst_brain-0.1.0/hkvc_graphics/src/frame_buffer.rs +445 -0
- catalyst_brain-0.1.0/hkvc_graphics/src/lib.rs +506 -0
- catalyst_brain-0.1.0/hkvc_graphics/src/path_tracer.rs +480 -0
- catalyst_brain-0.1.0/hkvc_graphics/src/quantum_scheduler.rs +437 -0
- catalyst_brain-0.1.0/holographic_quantization.py +1119 -0
- catalyst_brain-0.1.0/metalearning/Cargo.toml +8 -0
- catalyst_brain-0.1.0/metalearning/src/lib.rs +406 -0
- catalyst_brain-0.1.0/metalearning/tests/metalearning_tests.rs +243 -0
- catalyst_brain-0.1.0/mlx_backend.py +100 -0
- catalyst_brain-0.1.0/pyproject.toml +25 -0
- catalyst_brain-0.1.0/quantum_heads/Cargo.toml +8 -0
- catalyst_brain-0.1.0/quantum_heads/src/lib.rs +473 -0
- catalyst_brain-0.1.0/quantum_heads/tests/gates_tests.rs +221 -0
- catalyst_brain-0.1.0/rain_q.py +911 -0
- catalyst_brain-0.1.0/setup.cfg +4 -0
- catalyst_brain-0.1.0/setup.py +13 -0
- catalyst_brain-0.1.0/src/lib.rs +211 -0
- catalyst_brain-0.1.0/src/py_api.rs +157 -0
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
[package]
|
|
2
|
+
name = "catalyst_brain"
|
|
3
|
+
version.workspace = true
|
|
4
|
+
edition.workspace = true
|
|
5
|
+
authors.workspace = true
|
|
6
|
+
license.workspace = true
|
|
7
|
+
|
|
8
|
+
[lib]
|
|
9
|
+
name = "catalyst_hdc"
|
|
10
|
+
crate-type = ["cdylib"]
|
|
11
|
+
|
|
12
|
+
[dependencies]
|
|
13
|
+
pyo3 = { version = "0.22.0", features = ["extension-module"] }
|
|
14
|
+
rand = "0.8"
|
|
15
|
+
metalearning = { path = "metalearning" }
|
|
16
|
+
quantum_heads = { path = "quantum_heads" }
|
|
17
|
+
|
|
18
|
+
[workspace]
|
|
19
|
+
resolver = "2"
|
|
20
|
+
members = [
|
|
21
|
+
"hkvc_graphics",
|
|
22
|
+
"metalearning",
|
|
23
|
+
"quantum_heads",
|
|
24
|
+
]
|
|
25
|
+
|
|
26
|
+
[workspace.package]
|
|
27
|
+
version = "0.1.0"
|
|
28
|
+
edition = "2021"
|
|
29
|
+
authors = ["Strategic Innovations AI"]
|
|
30
|
+
license = "MIT"
|
|
31
|
+
|
|
32
|
+
[profile.dev]
|
|
33
|
+
opt-level = 1
|
|
34
|
+
|
|
35
|
+
[profile.release]
|
|
36
|
+
lto = true
|
|
37
|
+
codegen-units = 1
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: catalyst-brain
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Catalyst Brain: O(1) Holographic Key-Value Cache, 1-Bit Inference, and Metacognitive Swarm Engine.
|
|
5
|
+
License: MIT
|
|
6
|
+
Classifier: Programming Language :: Python :: 3
|
|
7
|
+
Classifier: Programming Language :: Rust
|
|
8
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
9
|
+
Requires-Python: >=3.10
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
Requires-Dist: fastapi
|
|
12
|
+
Requires-Dist: uvicorn
|
|
13
|
+
Requires-Dist: httpx
|
|
14
|
+
Requires-Dist: pydantic
|
|
15
|
+
Requires-Dist: mlx
|
|
16
|
+
Requires-Dist: mlx-lm
|
|
17
|
+
Requires-Dist: transformers
|
|
18
|
+
|
|
19
|
+
<div align="center">
|
|
20
|
+
<h1>🧠 Catalyst Brain SDK</h1>
|
|
21
|
+
<p><b>Agentic Meta-Swarm Router + O(1) Holographic Memory for Local AI</b></p>
|
|
22
|
+
</div>
|
|
23
|
+
|
|
24
|
+
Catalyst Brain is a **patent-pending** cognitive proxy architecture operating at the intersection of Agentic AI, Edge intelligence, and LLMOps. It provides **Holographic Key-Value Caching (HKVC)** coupled with a self-learning metacognitive swarm routing engine (`Rain-Q`), empowering local open-source LLMs to bypass standard attention memory bottlenecks.
|
|
25
|
+
|
|
26
|
+
## 🚀 The Core Breakthroughs
|
|
27
|
+
|
|
28
|
+
1. ⚡ **O(1) Holographic Phase Retrieval**
|
|
29
|
+
Standard Transformer KV-Caches scale $O(N)$ linearly with context sequence lengths. Catalyst's `ComplexAccumulator` projects embeddings deterministically into a 1-Bit BlockCodeVector (BCV) rotation phase space. Memory lookups operate with *constant time overhead* ($O(1)$) regardless of contextual length.
|
|
30
|
+
|
|
31
|
+
2. 💾 **8,000x Memory Footprint Reduction**
|
|
32
|
+
Simulated mathematically using standard `bipolar` vector structures vs FP16 limits:
|
|
33
|
+
* **Standard 1,000 Tokens (FP16 Attention):** ~12.2 GB
|
|
34
|
+
* **Catalyst HKVC 1,000 Tokens:** Exactly 1.53 MB (Constant Bound)
|
|
35
|
+
|
|
36
|
+
3. 🧬 **Self-Optimizing Cognitive State**
|
|
37
|
+
Stop writing rigid logic router prompts. Catalyst's `MetacognitionServer` creates self-aware feedback loops mimicking neurotransmitters (Dopamine, Acetylcholine). It benchmarks how models respond (using Resonance) and utilizes Hebbian mapping to autonomously proxy tasks to the most suitable open-source agent in your local system.
|
|
38
|
+
|
|
39
|
+
## 📦 Installation
|
|
40
|
+
|
|
41
|
+
Catalyst relies on an extremely fast, underlying Rust hardware acceleration sub-system called `catalyst_hdc` which escapes the Python GIL for dense geometric vector math operations.
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# Safely handles cross-platform Rust C-extension builds via Maturin:
|
|
45
|
+
pip install catalyst-brain
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## 🛠️ Usage (Native Apple Silicon `MLX`)
|
|
49
|
+
|
|
50
|
+
We support Black-box REST proxying through Ollama, but to tap into real structural memory caching, Catalyst ships natively supported for Apple Silicon via `mlx`!
|
|
51
|
+
|
|
52
|
+
```python
|
|
53
|
+
import os
|
|
54
|
+
from catalyst_brain_api import app
|
|
55
|
+
from catalyst_metacognition import get_metacognition
|
|
56
|
+
import uvicorn
|
|
57
|
+
|
|
58
|
+
# 1. Flip on MLX Interception
|
|
59
|
+
os.environ["USE_MLX"] = "true"
|
|
60
|
+
|
|
61
|
+
# 2. Boot the Cognitive Proxy!
|
|
62
|
+
uvicorn.run(app, host="0.0.0.0", port=8000)
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## 🤝 Contributing
|
|
67
|
+
We welcome research adaptations and system-level Pull Requests as we work toward integrating true Complex-domain accumulators into distributed Edge computing hardware profiles.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<h1>🧠 Catalyst Brain SDK</h1>
|
|
3
|
+
<p><b>Agentic Meta-Swarm Router + O(1) Holographic Memory for Local AI</b></p>
|
|
4
|
+
</div>
|
|
5
|
+
|
|
6
|
+
Catalyst Brain is a **patent-pending** cognitive proxy architecture operating at the intersection of Agentic AI, Edge intelligence, and LLMOps. It provides **Holographic Key-Value Caching (HKVC)** coupled with a self-learning metacognitive swarm routing engine (`Rain-Q`), empowering local open-source LLMs to bypass standard attention memory bottlenecks.
|
|
7
|
+
|
|
8
|
+
## 🚀 The Core Breakthroughs
|
|
9
|
+
|
|
10
|
+
1. ⚡ **O(1) Holographic Phase Retrieval**
|
|
11
|
+
Standard Transformer KV-Caches scale $O(N)$ linearly with context sequence lengths. Catalyst's `ComplexAccumulator` projects embeddings deterministically into a 1-Bit BlockCodeVector (BCV) rotation phase space. Memory lookups operate with *constant time overhead* ($O(1)$) regardless of contextual length.
|
|
12
|
+
|
|
13
|
+
2. 💾 **8,000x Memory Footprint Reduction**
|
|
14
|
+
Simulated mathematically using standard `bipolar` vector structures vs FP16 limits:
|
|
15
|
+
* **Standard 1,000 Tokens (FP16 Attention):** ~12.2 GB
|
|
16
|
+
* **Catalyst HKVC 1,000 Tokens:** Exactly 1.53 MB (Constant Bound)
|
|
17
|
+
|
|
18
|
+
3. 🧬 **Self-Optimizing Cognitive State**
|
|
19
|
+
Stop writing rigid logic router prompts. Catalyst's `MetacognitionServer` creates self-aware feedback loops mimicking neurotransmitters (Dopamine, Acetylcholine). It benchmarks how models respond (using Resonance) and utilizes Hebbian mapping to autonomously proxy tasks to the most suitable open-source agent in your local system.
|
|
20
|
+
|
|
21
|
+
## 📦 Installation
|
|
22
|
+
|
|
23
|
+
Catalyst relies on an extremely fast, underlying Rust hardware acceleration sub-system called `catalyst_hdc` which escapes the Python GIL for dense geometric vector math operations.
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# Safely handles cross-platform Rust C-extension builds via Maturin:
|
|
27
|
+
pip install catalyst-brain
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 🛠️ Usage (Native Apple Silicon `MLX`)
|
|
31
|
+
|
|
32
|
+
We support Black-box REST proxying through Ollama, but to tap into real structural memory caching, Catalyst ships natively supported for Apple Silicon via `mlx`!
|
|
33
|
+
|
|
34
|
+
```python
|
|
35
|
+
import os
|
|
36
|
+
from catalyst_brain_api import app
|
|
37
|
+
from catalyst_metacognition import get_metacognition
|
|
38
|
+
import uvicorn
|
|
39
|
+
|
|
40
|
+
# 1. Flip on MLX Interception
|
|
41
|
+
os.environ["USE_MLX"] = "true"
|
|
42
|
+
|
|
43
|
+
# 2. Boot the Cognitive Proxy!
|
|
44
|
+
uvicorn.run(app, host="0.0.0.0", port=8000)
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## 🤝 Contributing
|
|
49
|
+
We welcome research adaptations and system-level Pull Requests as we work toward integrating true Complex-domain accumulators into distributed Edge computing hardware profiles.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: catalyst-brain
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Catalyst Brain: O(1) Holographic Key-Value Cache, 1-Bit Inference, and Metacognitive Swarm Engine.
|
|
5
|
+
License: MIT
|
|
6
|
+
Classifier: Programming Language :: Python :: 3
|
|
7
|
+
Classifier: Programming Language :: Rust
|
|
8
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
9
|
+
Requires-Python: >=3.10
|
|
10
|
+
Description-Content-Type: text/markdown
|
|
11
|
+
Requires-Dist: fastapi
|
|
12
|
+
Requires-Dist: uvicorn
|
|
13
|
+
Requires-Dist: httpx
|
|
14
|
+
Requires-Dist: pydantic
|
|
15
|
+
Requires-Dist: mlx
|
|
16
|
+
Requires-Dist: mlx-lm
|
|
17
|
+
Requires-Dist: transformers
|
|
18
|
+
|
|
19
|
+
<div align="center">
|
|
20
|
+
<h1>🧠 Catalyst Brain SDK</h1>
|
|
21
|
+
<p><b>Agentic Meta-Swarm Router + O(1) Holographic Memory for Local AI</b></p>
|
|
22
|
+
</div>
|
|
23
|
+
|
|
24
|
+
Catalyst Brain is a **patent-pending** cognitive proxy architecture operating at the intersection of Agentic AI, Edge intelligence, and LLMOps. It provides **Holographic Key-Value Caching (HKVC)** coupled with a self-learning metacognitive swarm routing engine (`Rain-Q`), empowering local open-source LLMs to bypass standard attention memory bottlenecks.
|
|
25
|
+
|
|
26
|
+
## 🚀 The Core Breakthroughs
|
|
27
|
+
|
|
28
|
+
1. ⚡ **O(1) Holographic Phase Retrieval**
|
|
29
|
+
Standard Transformer KV-Caches scale $O(N)$ linearly with context sequence lengths. Catalyst's `ComplexAccumulator` projects embeddings deterministically into a 1-Bit BlockCodeVector (BCV) rotation phase space. Memory lookups operate with *constant time overhead* ($O(1)$) regardless of contextual length.
|
|
30
|
+
|
|
31
|
+
2. 💾 **8,000x Memory Footprint Reduction**
|
|
32
|
+
Simulated mathematically using standard `bipolar` vector structures vs FP16 limits:
|
|
33
|
+
* **Standard 1,000 Tokens (FP16 Attention):** ~12.2 GB
|
|
34
|
+
* **Catalyst HKVC 1,000 Tokens:** Exactly 1.53 MB (Constant Bound)
|
|
35
|
+
|
|
36
|
+
3. 🧬 **Self-Optimizing Cognitive State**
|
|
37
|
+
Stop writing rigid logic router prompts. Catalyst's `MetacognitionServer` creates self-aware feedback loops mimicking neurotransmitters (Dopamine, Acetylcholine). It benchmarks how models respond (using Resonance) and utilizes Hebbian mapping to autonomously proxy tasks to the most suitable open-source agent in your local system.
|
|
38
|
+
|
|
39
|
+
## 📦 Installation
|
|
40
|
+
|
|
41
|
+
Catalyst relies on an extremely fast, underlying Rust hardware acceleration sub-system called `catalyst_hdc` which escapes the Python GIL for dense geometric vector math operations.
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# Safely handles cross-platform Rust C-extension builds via Maturin:
|
|
45
|
+
pip install catalyst-brain
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## 🛠️ Usage (Native Apple Silicon `MLX`)
|
|
49
|
+
|
|
50
|
+
We support Black-box REST proxying through Ollama, but to tap into real structural memory caching, Catalyst ships natively supported for Apple Silicon via `mlx`!
|
|
51
|
+
|
|
52
|
+
```python
|
|
53
|
+
import os
|
|
54
|
+
from catalyst_brain_api import app
|
|
55
|
+
from catalyst_metacognition import get_metacognition
|
|
56
|
+
import uvicorn
|
|
57
|
+
|
|
58
|
+
# 1. Flip on MLX Interception
|
|
59
|
+
os.environ["USE_MLX"] = "true"
|
|
60
|
+
|
|
61
|
+
# 2. Boot the Cognitive Proxy!
|
|
62
|
+
uvicorn.run(app, host="0.0.0.0", port=8000)
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## 🤝 Contributing
|
|
67
|
+
We welcome research adaptations and system-level Pull Requests as we work toward integrating true Complex-domain accumulators into distributed Edge computing hardware profiles.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
Cargo.toml
|
|
2
|
+
MANIFEST.in
|
|
3
|
+
README.md
|
|
4
|
+
catalyst_brain_api.py
|
|
5
|
+
catalyst_metacognition.py
|
|
6
|
+
holographic_quantization.py
|
|
7
|
+
mlx_backend.py
|
|
8
|
+
pyproject.toml
|
|
9
|
+
rain_q.py
|
|
10
|
+
setup.py
|
|
11
|
+
catalyst_brain.egg-info/PKG-INFO
|
|
12
|
+
catalyst_brain.egg-info/SOURCES.txt
|
|
13
|
+
catalyst_brain.egg-info/dependency_links.txt
|
|
14
|
+
catalyst_brain.egg-info/requires.txt
|
|
15
|
+
catalyst_brain.egg-info/top_level.txt
|
|
16
|
+
hkvc_graphics/Cargo.toml
|
|
17
|
+
hkvc_graphics/src/bvh.rs
|
|
18
|
+
hkvc_graphics/src/frame_buffer.rs
|
|
19
|
+
hkvc_graphics/src/lib.rs
|
|
20
|
+
hkvc_graphics/src/path_tracer.rs
|
|
21
|
+
hkvc_graphics/src/quantum_scheduler.rs
|
|
22
|
+
metalearning/Cargo.toml
|
|
23
|
+
metalearning/src/lib.rs
|
|
24
|
+
metalearning/tests/metalearning_tests.rs
|
|
25
|
+
quantum_heads/Cargo.toml
|
|
26
|
+
quantum_heads/src/lib.rs
|
|
27
|
+
quantum_heads/tests/gates_tests.rs
|
|
28
|
+
src/lib.rs
|
|
29
|
+
src/py_api.rs
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|