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.
Files changed (31) hide show
  1. catalyst_brain-0.1.0/Cargo.toml +37 -0
  2. catalyst_brain-0.1.0/MANIFEST.in +5 -0
  3. catalyst_brain-0.1.0/PKG-INFO +67 -0
  4. catalyst_brain-0.1.0/README.md +49 -0
  5. catalyst_brain-0.1.0/catalyst_brain.egg-info/PKG-INFO +67 -0
  6. catalyst_brain-0.1.0/catalyst_brain.egg-info/SOURCES.txt +29 -0
  7. catalyst_brain-0.1.0/catalyst_brain.egg-info/dependency_links.txt +1 -0
  8. catalyst_brain-0.1.0/catalyst_brain.egg-info/requires.txt +7 -0
  9. catalyst_brain-0.1.0/catalyst_brain.egg-info/top_level.txt +5 -0
  10. catalyst_brain-0.1.0/catalyst_brain_api.py +1003 -0
  11. catalyst_brain-0.1.0/catalyst_metacognition.py +575 -0
  12. catalyst_brain-0.1.0/hkvc_graphics/Cargo.toml +18 -0
  13. catalyst_brain-0.1.0/hkvc_graphics/src/bvh.rs +367 -0
  14. catalyst_brain-0.1.0/hkvc_graphics/src/frame_buffer.rs +445 -0
  15. catalyst_brain-0.1.0/hkvc_graphics/src/lib.rs +506 -0
  16. catalyst_brain-0.1.0/hkvc_graphics/src/path_tracer.rs +480 -0
  17. catalyst_brain-0.1.0/hkvc_graphics/src/quantum_scheduler.rs +437 -0
  18. catalyst_brain-0.1.0/holographic_quantization.py +1119 -0
  19. catalyst_brain-0.1.0/metalearning/Cargo.toml +8 -0
  20. catalyst_brain-0.1.0/metalearning/src/lib.rs +406 -0
  21. catalyst_brain-0.1.0/metalearning/tests/metalearning_tests.rs +243 -0
  22. catalyst_brain-0.1.0/mlx_backend.py +100 -0
  23. catalyst_brain-0.1.0/pyproject.toml +25 -0
  24. catalyst_brain-0.1.0/quantum_heads/Cargo.toml +8 -0
  25. catalyst_brain-0.1.0/quantum_heads/src/lib.rs +473 -0
  26. catalyst_brain-0.1.0/quantum_heads/tests/gates_tests.rs +221 -0
  27. catalyst_brain-0.1.0/rain_q.py +911 -0
  28. catalyst_brain-0.1.0/setup.cfg +4 -0
  29. catalyst_brain-0.1.0/setup.py +13 -0
  30. catalyst_brain-0.1.0/src/lib.rs +211 -0
  31. 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,5 @@
1
+ include Cargo.toml
2
+ recursive-include src *
3
+ recursive-include quantum_heads *
4
+ recursive-include metalearning *
5
+ recursive-include hkvc_graphics *
@@ -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,7 @@
1
+ fastapi
2
+ uvicorn
3
+ httpx
4
+ pydantic
5
+ mlx
6
+ mlx-lm
7
+ transformers
@@ -0,0 +1,5 @@
1
+ catalyst_brain_api
2
+ catalyst_metacognition
3
+ holographic_quantization
4
+ mlx_backend
5
+ rain_q