kore-stack 0.1.0__tar.gz

kore_stack-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iafiscal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kore_stack-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: kore-stack
+Version: 0.1.0
+Summary: Complete cognitive middleware stack for LLMs. Memory + routing + cache + observability in one install.
+Author: iafiscal
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cache,cognitive,identity,llm,memory,middleware,routing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: kore-bridge>=0.2.1
+Requires-Dist: kore-mind>=0.2.1
+Requires-Dist: sc-router>=0.2.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.20; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20; extra == 'anthropic'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# kore-stack
+
+Complete cognitive middleware stack for LLMs. One install, everything connected.
+
+**Memory + Identity + Cache + Routing + Observability + A/B Testing.**
+
+The difference with LangChain/LlamaIndex: kore's routing is based on formal proof complexity theory (Selector Complexity), not heuristics.
+
+## Install
+
+```bash
+pip install kore-stack               # core (Ollama-ready)
+pip install kore-stack[openai]       # + OpenAI
+pip install kore-stack[anthropic]    # + Anthropic
+pip install kore-stack[all]          # everything
+```
+
+## Quick start
+
+```python
+from kore_stack import Mind, Bridge, OllamaProvider
+
+mind = Mind("agent.db")
+llm = OllamaProvider(model="llama3.2")
+bridge = Bridge(mind=mind, llm=llm, cache_ttl=3600.0)
+
+response = bridge.think("Help me with my proof", user="carlos")
+```
+
+## What's in the stack
+
+### kore-mind — Persistent memory engine
+```python
+from kore_stack import Mind
+
+mind = Mind("agent.db", enable_traces=True)
+mind.experience("User likes Python", source="carlos")
+memories = mind.recall("Python", source="carlos")
+
+# Scoped views per user
+alice = mind.scoped("alice")
+alice.experience("Prefers Rust")
+```
+
+### kore-bridge — LLM cognitive middleware
+```python
+from kore_stack import Bridge, OllamaProvider
+
+bridge = Bridge(
+    mind=mind,
+    llm=OllamaProvider(),
+    cache_ttl=3600.0,    # smart cache
+    rate_limit=3,         # cognitive rate limiting
+    rate_window=3600.0,
+)
+
+# Cache hit → no LLM call. Rate limited → respond from memory.
+response = bridge.think("What is P vs NP?", user="carlos")
+```
+
+### sc-router — Routing based on Selector Complexity
+```python
+from kore_stack import (
+    SCRouterProvider, ToolCatalog, Tool,
+    OllamaProvider, Bridge, Mind,
+)
+from kore_bridge.providers import OpenAIProvider
+
+# Define your tool catalog
+catalog = ToolCatalog()
+catalog.register(Tool(
+    name="calculator",
+    description="Arithmetic calculations",
+    input_types={"expression"},
+    output_types={"number"},
+    capability_tags={"math", "calculate"},
+))
+
+# SC routing: simple queries → local Ollama, complex → GPT-4
+router = SCRouterProvider(
+    providers={
+        "fast": OllamaProvider(model="llama3.2"),
+        "quality": OpenAIProvider(model="gpt-4o"),
+    },
+    catalog=catalog,
+)
+
+bridge = Bridge(mind=Mind("agent.db"), llm=router)
+bridge.think("What is 2+2?")        # SC(0) → Ollama
+bridge.think("Analyze market trends, cross-reference sentiment, build prediction model")
+                                      # SC(2-3) → GPT-4
+print(router.last_sc_level)          # 0, 1, 2, or 3
+```
+
+### A/B Testing
+```python
+from kore_stack import Experiment, OllamaProvider, Mind
+
+exp = Experiment(
+    Mind("test.db"),
+    variant_a=OllamaProvider(model="llama3.2"),
+    variant_b=OllamaProvider(model="mistral"),
+)
+
+result = exp.run("Explain recursion")
+print(f"A: {result.time_a_ms:.0f}ms, B: {result.time_b_ms:.0f}ms, faster: {result.faster}")
+```
+
+## Architecture
+
+```
+┌─────────────┐
+│   Your App  │
+└──────┬──────┘
+       │
+┌──────▼──────┐
+│ kore-bridge │  Cache → Rate Limit → SC Route → LLM
+│  (Bridge)   │
+└──────┬──────┘
+       │
+┌──────▼──────┐     ┌───────────┐
+│  kore-mind  │     │ sc-router │
+│   (Mind)    │     │  SC(0-3)  │
+│   SQLite    │     └───────────┘
+└─────────────┘
+```
+
+## Packages
+
+| Package | PyPI | What it does |
+|---------|------|-------------|
+| [kore-mind](https://github.com/iafiscal1212/kore-mind) | `pip install kore-mind` | Memory, identity, traces, cache storage |
+| [kore-bridge](https://github.com/iafiscal1212/kore-bridge) | `pip install kore-bridge` | LLM integration, cache logic, rate limiting, A/B |
+| [sc-router](https://github.com/iafiscal1212/sc-router) | `pip install sc-router` | Query routing by Selector Complexity |
+| **kore-stack** | `pip install kore-stack` | **All of the above, one install** |
+
+## License
+
+MIT

kore_stack-0.1.0/README.md

@@ -0,0 +1,139 @@
+# kore-stack
+
+Complete cognitive middleware stack for LLMs. One install, everything connected.
+
+**Memory + Identity + Cache + Routing + Observability + A/B Testing.**
+
+The difference with LangChain/LlamaIndex: kore's routing is based on formal proof complexity theory (Selector Complexity), not heuristics.
+
+## Install
+
+```bash
+pip install kore-stack               # core (Ollama-ready)
+pip install kore-stack[openai]       # + OpenAI
+pip install kore-stack[anthropic]    # + Anthropic
+pip install kore-stack[all]          # everything
+```
+
+## Quick start
+
+```python
+from kore_stack import Mind, Bridge, OllamaProvider
+
+mind = Mind("agent.db")
+llm = OllamaProvider(model="llama3.2")
+bridge = Bridge(mind=mind, llm=llm, cache_ttl=3600.0)
+
+response = bridge.think("Help me with my proof", user="carlos")
+```
+
+## What's in the stack
+
+### kore-mind — Persistent memory engine
+```python
+from kore_stack import Mind
+
+mind = Mind("agent.db", enable_traces=True)
+mind.experience("User likes Python", source="carlos")
+memories = mind.recall("Python", source="carlos")
+
+# Scoped views per user
+alice = mind.scoped("alice")
+alice.experience("Prefers Rust")
+```
+
+### kore-bridge — LLM cognitive middleware
+```python
+from kore_stack import Bridge, OllamaProvider
+
+bridge = Bridge(
+    mind=mind,
+    llm=OllamaProvider(),
+    cache_ttl=3600.0,    # smart cache
+    rate_limit=3,         # cognitive rate limiting
+    rate_window=3600.0,
+)
+
+# Cache hit → no LLM call. Rate limited → respond from memory.
+response = bridge.think("What is P vs NP?", user="carlos")
+```
+
+### sc-router — Routing based on Selector Complexity
+```python
+from kore_stack import (
+    SCRouterProvider, ToolCatalog, Tool,
+    OllamaProvider, Bridge, Mind,
+)
+from kore_bridge.providers import OpenAIProvider
+
+# Define your tool catalog
+catalog = ToolCatalog()
+catalog.register(Tool(
+    name="calculator",
+    description="Arithmetic calculations",
+    input_types={"expression"},
+    output_types={"number"},
+    capability_tags={"math", "calculate"},
+))
+
+# SC routing: simple queries → local Ollama, complex → GPT-4
+router = SCRouterProvider(
+    providers={
+        "fast": OllamaProvider(model="llama3.2"),
+        "quality": OpenAIProvider(model="gpt-4o"),
+    },
+    catalog=catalog,
+)
+
+bridge = Bridge(mind=Mind("agent.db"), llm=router)
+bridge.think("What is 2+2?")        # SC(0) → Ollama
+bridge.think("Analyze market trends, cross-reference sentiment, build prediction model")
+                                      # SC(2-3) → GPT-4
+print(router.last_sc_level)          # 0, 1, 2, or 3
+```
+
+### A/B Testing
+```python
+from kore_stack import Experiment, OllamaProvider, Mind
+
+exp = Experiment(
+    Mind("test.db"),
+    variant_a=OllamaProvider(model="llama3.2"),
+    variant_b=OllamaProvider(model="mistral"),
+)
+
+result = exp.run("Explain recursion")
+print(f"A: {result.time_a_ms:.0f}ms, B: {result.time_b_ms:.0f}ms, faster: {result.faster}")
+```
+
+## Architecture
+
+```
+┌─────────────┐
+│   Your App  │
+└──────┬──────┘
+       │
+┌──────▼──────┐
+│ kore-bridge │  Cache → Rate Limit → SC Route → LLM
+│  (Bridge)   │
+└──────┬──────┘
+       │
+┌──────▼──────┐     ┌───────────┐
+│  kore-mind  │     │ sc-router │
+│   (Mind)    │     │  SC(0-3)  │
+│   SQLite    │     └───────────┘
+└─────────────┘
+```
+
+## Packages
+
+| Package | PyPI | What it does |
+|---------|------|-------------|
+| [kore-mind](https://github.com/iafiscal1212/kore-mind) | `pip install kore-mind` | Memory, identity, traces, cache storage |
+| [kore-bridge](https://github.com/iafiscal1212/kore-bridge) | `pip install kore-bridge` | LLM integration, cache logic, rate limiting, A/B |
+| [sc-router](https://github.com/iafiscal1212/sc-router) | `pip install sc-router` | Query routing by Selector Complexity |
+| **kore-stack** | `pip install kore-stack` | **All of the above, one install** |
+
+## License
+
+MIT

kore_stack-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "kore-stack"
+version = "0.1.0"
+description = "Complete cognitive middleware stack for LLMs. Memory + routing + cache + observability in one install."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "iafiscal" },
+]
+keywords = ["llm", "memory", "identity", "cognitive", "ai", "routing", "cache", "middleware"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "kore-mind>=0.2.1",
+    "kore-bridge>=0.2.1",
+    "sc-router>=0.2.0",
+]
+
+[project.optional-dependencies]
+openai = ["openai>=1.0"]
+anthropic = ["anthropic>=0.20"]
+all = ["openai>=1.0", "anthropic>=0.20"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/kore_stack"]

kore_stack-0.1.0/src/kore_stack/__init__.py

@@ -0,0 +1,29 @@
+"""kore-stack: Complete cognitive middleware stack for LLMs.
+
+One install, everything connected:
+    pip install kore-stack
+
+Includes:
+    - kore-mind: Persistent memory + emergent identity
+    - kore-bridge: LLM integration with cache, rate limiting, A/B testing
+    - sc-router: Query routing based on Selector Complexity theory
+"""
+
+# Re-export everything for convenience
+from kore_mind import Mind, Memory, Identity, MemoryType, Trace, CacheEntry
+from kore_bridge import (
+    Bridge, LLMProvider, CallableLLM, OllamaProvider,
+    RouterProvider, SCRouterProvider, Experiment, ExperimentResult,
+)
+from sc_router import ToolCatalog, Tool, route
+
+__version__ = "0.1.0"
+__all__ = [
+    # Mind
+    "Mind", "Memory", "Identity", "MemoryType", "Trace", "CacheEntry",
+    # Bridge
+    "Bridge", "LLMProvider", "CallableLLM", "OllamaProvider",
+    "RouterProvider", "SCRouterProvider", "Experiment", "ExperimentResult",
+    # SC Router
+    "ToolCatalog", "Tool", "route",
+]