neuralnode 2.2.5__tar.gz → 2.2.7__tar.gz

{neuralnode-2.2.5 → neuralnode-2.2.7}/.env.example

@@ -15,6 +15,10 @@ GOOGLE_API_KEY=your-google-api-key-here
 # No API key needed, just ensure Ollama is running
 OLLAMA_BASE_URL=http://localhost:11434
 
+# Horus Cyper Nano 1.0 BETA Early Access
+HORUS_CYPER_NANO_API_KEY=horusNN-your-access-token
+HORUS_CYPER_NANO_BASE_URL=https://api.tokenai.llc/v1
+
 # NeuralNode Settings
 NEURALNODE_DEFAULT_PROVIDER=auto
 NEURALNODE_MEMORY_ENABLED=true

{neuralnode-2.2.5 → neuralnode-2.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuralnode
-Version: 2.2.5
+Version: 2.2.7
 Summary: Comprehensive AI Framework with 50+ LLM Providers, Advanced Agents, Chains, Memory, RAG, and 100+ Tools
 Project-URL: Homepage, https://assem.cloud/
 Project-URL: Documentation, https://neuralnode.readthedocs.io
@@ -178,7 +178,7 @@ Provides-Extra: whatsapp
 Requires-Dist: twilio>=9.0.0; extra == 'whatsapp'
 Description-Content-Type: text/markdown
 
-# NeuralNode v2.2.0
+# NeuralNode v2.2.7
 
 NeuralNode is a Python AI framework focused on:
 - real cloud providers that are implemented
@@ -220,7 +220,34 @@ print(ai.chat("Hello from NeuralNode"))
 
 ## Horus
 
-All Horus models use:
+### Horus Cyper Nano 1.0 BETA Early Access API
+
+Horus Cyper Nano 1.0 BETA is a Text-to-Text model. Approved Early Access users can call the hosted model through the same
+`NeuralNode` interface. Each Access Token has its own server-enforced RPM limit,
+and API conversations are retained by TokenAI under the Early Access terms.
+
+```python
+import neuralnode as nn
+
+ai = nn.NeuralNode(
+    provider="horus-cyper-nano",
+    model="horus-cyper-nano-1.0-beta",
+    api_key="horusNN-XXXXXXXXXXXXXXXX",
+)
+
+print(ai.chat("Review this code for defensive cybersecurity issues."))
+```
+
+The client reads `HORUS_CYPER_NANO_API_KEY` automatically. Override
+`HORUS_CYPER_NANO_BASE_URL` only when TokenAI provides a different API endpoint.
+The production API base URL is `https://api.tokenai.llc/v1`. Agent Mode supports
+function tools, required or named tool choices, tool-result messages, and
+buffered SSE compatibility streams. The hosted Early Access model has a 32,768
+token context. See `examples/horus_cyper_nano_agent_mode.py` for the complete
+tool-call round trip. NeuralNode retries temporary HTTP 429, 502, and 503
+responses up to two times by default and respects the API Retry-After header.
+
+Locally loaded Horus models use:
 - unified chat template: `horus_unified`
 - unified context window: `8192`
 

{neuralnode-2.2.5 → neuralnode-2.2.7}/README.md

@@ -1,4 +1,4 @@
-# NeuralNode v2.2.0
+# NeuralNode v2.2.7
 
 NeuralNode is a Python AI framework focused on:
 - real cloud providers that are implemented
@@ -40,7 +40,34 @@ print(ai.chat("Hello from NeuralNode"))
 
 ## Horus
 
-All Horus models use:
+### Horus Cyper Nano 1.0 BETA Early Access API
+
+Horus Cyper Nano 1.0 BETA is a Text-to-Text model. Approved Early Access users can call the hosted model through the same
+`NeuralNode` interface. Each Access Token has its own server-enforced RPM limit,
+and API conversations are retained by TokenAI under the Early Access terms.
+
+```python
+import neuralnode as nn
+
+ai = nn.NeuralNode(
+    provider="horus-cyper-nano",
+    model="horus-cyper-nano-1.0-beta",
+    api_key="horusNN-XXXXXXXXXXXXXXXX",
+)
+
+print(ai.chat("Review this code for defensive cybersecurity issues."))
+```
+
+The client reads `HORUS_CYPER_NANO_API_KEY` automatically. Override
+`HORUS_CYPER_NANO_BASE_URL` only when TokenAI provides a different API endpoint.
+The production API base URL is `https://api.tokenai.llc/v1`. Agent Mode supports
+function tools, required or named tool choices, tool-result messages, and
+buffered SSE compatibility streams. The hosted Early Access model has a 32,768
+token context. See `examples/horus_cyper_nano_agent_mode.py` for the complete
+tool-call round trip. NeuralNode retries temporary HTTP 429, 502, and 503
+responses up to two times by default and respects the API Retry-After header.
+
+Locally loaded Horus models use:
 - unified chat template: `horus_unified`
 - unified context window: `8192`
 

neuralnode-2.2.7/examples/horus_cyper_nano_agent_mode.py

@@ -0,0 +1,67 @@
+"""Horus Cyper Nano 1.0 BETA Agent Mode example."""
+
+import json
+import os
+
+import neuralnode as nn
+
+
+def get_service_status(target: str) -> dict[str, str]:
+    """Example local tool executed by the application, not by the model."""
+    return {"target": target, "status": "healthy"}
+
+
+def main() -> None:
+    provider = nn.HorusCyperNanoProvider(
+        api_key=os.environ["HORUS_CYPER_NANO_API_KEY"],
+    )
+    tools = [
+        {
+            "type": "function",
+            "function": {
+                "name": "get_service_status",
+                "description": "Read the health status of an approved service.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "target": {"type": "string"},
+                    },
+                    "required": ["target"],
+                    "additionalProperties": False,
+                },
+            },
+        }
+    ]
+    messages = [
+        {"role": "user", "content": "Check the gateway status and summarize the result."},
+    ]
+
+    first = provider.chat(messages, tools=tools, tool_choice="required")
+    if not first["tool_calls"]:
+        print(first["content"])
+        return
+
+    messages.append(
+        {
+            "role": "assistant",
+            "content": first["content"] or None,
+            "tool_calls": first["tool_calls"],
+        }
+    )
+    for tool_call in first["tool_calls"]:
+        arguments = json.loads(tool_call["function"]["arguments"])
+        result = get_service_status(**arguments)
+        messages.append(
+            {
+                "role": "tool",
+                "tool_call_id": tool_call["id"],
+                "content": json.dumps(result),
+            }
+        )
+
+    final = provider.chat(messages)
+    print(final["content"])
+
+
+if __name__ == "__main__":
+    main()

neuralnode-2.2.7/examples/horus_cyper_nano_early_access.py

@@ -0,0 +1,22 @@
+"""Horus Cyper Nano 1.0 BETA Text-to-Text Early Access example."""
+
+import os
+
+import neuralnode as nn
+
+
+def main() -> None:
+    client = nn.NeuralNode(
+        provider="horus-cyper-nano",
+        model="horus-cyper-nano-1.0-beta",
+        api_key=os.environ["HORUS_CYPER_NANO_API_KEY"],
+    )
+
+    answer = client.chat(
+        "Review this authentication flow for defensive security weaknesses."
+    )
+    print(answer)
+
+
+if __name__ == "__main__":
+    main()

{neuralnode-2.2.5 → neuralnode-2.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "neuralnode"
-version = "2.2.5"
+version = "2.2.7"
 description = "Comprehensive AI Framework with 50+ LLM Providers, Advanced Agents, Chains, Memory, RAG, and 100+ Tools"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -214,6 +214,10 @@ Changelog = "https://github.com/assemsabry/neuralnode/blob/main/CHANGELOG.md"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/neuralnode"]
+exclude = [
+    "**/__pycache__/**",
+    "**/*.pyc",
+]
 
 [tool.hatch.build.targets.sdist]
 exclude = [
@@ -222,10 +226,13 @@ exclude = [
     "/.tmp_*",
     "/actionlint.zip",
     "/actionlint_bin",
+    "/deployment",
     "/dist",
     "/dist_*",
     "/outputs",
     "/temp_header.gguf",
+    "**/__pycache__/**",
+    "**/*.pyc",
 ]
 
 [tool.black]

{neuralnode-2.2.5 → neuralnode-2.2.7}/src/neuralnode/__init__.py

@@ -42,7 +42,7 @@ Quick Start::
     text = sr.listen()
 """
 
-__version__ = "2.2.5"
+__version__ = "2.2.7"
 __author__ = "NeuralNode Contributors"
 
 # ── Core types ────────────────────────────────────────────────────────────────
@@ -78,6 +78,9 @@ from .providers import (
     MistralProvider,
     CohereProvider,
     DeepSeekProvider,
+    HorusCyperNano,
+    HorusCyperNanoAPIError,
+    HorusCyperNanoProvider,
     LlamaCppProvider,
     TransformersProvider,
     UniversalLocalProvider,
@@ -661,6 +664,7 @@ __all__ = [
     "get_available_providers", "is_local_provider",
     "OllamaProvider", "AnthropicProvider", "GoogleProvider",
     "GroqProvider", "MistralProvider", "CohereProvider", "DeepSeekProvider",
+    "HorusCyperNano", "HorusCyperNanoAPIError", "HorusCyperNanoProvider",
     "LlamaCppProvider", "TransformersProvider", "UniversalLocalProvider",
     "Horus", "HorusLensModel", "HorusModel", "HorusProvider", "load_horus_lens", "print_model_list",