neuralnode 2.1.13__tar.gz → 2.2.0__tar.gz

{neuralnode-2.1.13 → neuralnode-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuralnode
-Version: 2.1.13
+Version: 2.2.0
 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
@@ -38,6 +38,7 @@ Requires-Dist: cohere>=4.0.0; extra == 'all'
 Requires-Dist: edge-tts>=6.1.0; extra == 'all'
 Requires-Dist: einops>=0.7.0; extra == 'all'
 Requires-Dist: faiss-cpu>=1.7.4; extra == 'all'
+Requires-Dist: fastapi>=0.110.0; extra == 'all'
 Requires-Dist: gguf; extra == 'all'
 Requires-Dist: google-generativeai>=0.3.0; extra == 'all'
 Requires-Dist: groq>=0.4.0; extra == 'all'
@@ -59,6 +60,8 @@ Requires-Dist: speechrecognition>=3.10.0; extra == 'all'
 Requires-Dist: sqlalchemy>=2.0.0; extra == 'all'
 Requires-Dist: torch>=2.0.0; extra == 'all'
 Requires-Dist: transformers>=4.35.0; extra == 'all'
+Requires-Dist: twilio>=9.0.0; extra == 'all'
+Requires-Dist: uvicorn>=0.27.0; extra == 'all'
 Provides-Extra: anthropic
 Requires-Dist: anthropic>=0.8.0; extra == 'anthropic'
 Provides-Extra: aws
@@ -133,6 +136,9 @@ Provides-Extra: ollama
 Requires-Dist: ollama>=0.1.0; extra == 'ollama'
 Provides-Extra: openai
 Requires-Dist: openai>=1.0.0; extra == 'openai'
+Provides-Extra: openclaw
+Requires-Dist: fastapi>=0.110.0; extra == 'openclaw'
+Requires-Dist: uvicorn>=0.27.0; extra == 'openclaw'
 Provides-Extra: pinecone
 Requires-Dist: pinecone-client>=2.2.0; extra == 'pinecone'
 Provides-Extra: qdrant
@@ -168,9 +174,11 @@ Requires-Dist: wikipedia>=1.4.0; extra == 'tools'
 Provides-Extra: turboquant
 Provides-Extra: weaviate
 Requires-Dist: weaviate-client>=3.0.0; extra == 'weaviate'
+Provides-Extra: whatsapp
+Requires-Dist: twilio>=9.0.0; extra == 'whatsapp'
 Description-Content-Type: text/markdown
 
-# NeuralNode v3.1.0
+# NeuralNode v2.2.0
 
 NeuralNode is a Python AI framework focused on:
 - real cloud providers that are implemented
@@ -402,3 +410,16 @@ If the `turboquant` package is not installed or the backend cannot use it, Neura
 - OpenAI is intentionally blocked in NeuralNode.
 - GGUF Horus models require `llama-cpp-python`.
 - Horus downloads from Hugging Face require `huggingface_hub`.
+
+## OpenClaw Integration
+
+NeuralNode 2.2.0 introduces full end-to-end integration with OpenClaw. You can easily set up, start, and control OpenClaw directly through the framework.
+
+The integration operates by running a local FastAPI server in the background that exposes an OpenAI-compatible API to the OpenClaw Node gateway. This server proxies LLM requests directly to NeuralNode providers, allowing seamless interaction.
+
+It also fully supports the WhatsApp API, allowing users to activate it and bind it to their phone numbers entirely via code and OpenClaw.
+
+## Links
+
+- **TokenAI**: [https://tokenai.cloud/](https://tokenai.cloud/)
+- **NeuralNode**: [https://neuralnode.tokenai.cloud/](https://neuralnode.tokenai.cloud/)

{neuralnode-2.1.13 → neuralnode-2.2.0}/README.md

@@ -1,4 +1,4 @@
-# NeuralNode v3.1.0
+# NeuralNode v2.2.0
 
 NeuralNode is a Python AI framework focused on:
 - real cloud providers that are implemented
@@ -230,3 +230,16 @@ If the `turboquant` package is not installed or the backend cannot use it, Neura
 - OpenAI is intentionally blocked in NeuralNode.
 - GGUF Horus models require `llama-cpp-python`.
 - Horus downloads from Hugging Face require `huggingface_hub`.
+
+## OpenClaw Integration
+
+NeuralNode 2.2.0 introduces full end-to-end integration with OpenClaw. You can easily set up, start, and control OpenClaw directly through the framework.
+
+The integration operates by running a local FastAPI server in the background that exposes an OpenAI-compatible API to the OpenClaw Node gateway. This server proxies LLM requests directly to NeuralNode providers, allowing seamless interaction.
+
+It also fully supports the WhatsApp API, allowing users to activate it and bind it to their phone numbers entirely via code and OpenClaw.
+
+## Links
+
+- **TokenAI**: [https://tokenai.cloud/](https://tokenai.cloud/)
+- **NeuralNode**: [https://neuralnode.tokenai.cloud/](https://neuralnode.tokenai.cloud/)

{neuralnode-2.1.13 → neuralnode-2.2.0}/docker-compose.yml

@@ -5,7 +5,6 @@ services:
     build: .
     container_name: neuralnode
     environment:
-      - OPENAI_API_KEY=${OPENAI_API_KEY}
       - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
       - TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}
       - NEURALNODE_LOG_LEVEL=INFO

neuralnode-2.2.0/examples/openclaw_demo.py

@@ -0,0 +1,105 @@
+"""
+NeuralNode OpenClaw Integration Demo
+====================================
+
+This script demonstrates how to download, setup, configure, start, and control
+the OpenClaw gateway from within your NeuralNode framework.
+"""
+
+import time
+import os
+import neuralnode as nn
+from neuralnode.integrations.openclaw import OpenClawManager
+
+def main():
+    print("🚀 NeuralNode OpenClaw Manager Demo")
+    print("=" * 60)
+
+    # 1. Initialize any NeuralNode LLM instance (cloud or local)
+    # OpenClaw will route its API requests to this model.
+    print("\n1. Initializing NeuralNode...")
+    
+    # We will use auto-select provider or default mock provider for demonstration.
+    # In production, set your API keys (e.g. GEMINI_API_KEY, GROQ_API_KEY, etc.)
+    try:
+        ai = nn.NeuralNode(provider="auto")
+    except Exception:
+        # Fallback to a mock provider if no keys are set
+        print("   ⚠️ No provider keys found. Falling back to ollama for demonstration.")
+        ai = nn.NeuralNode(provider="ollama", model="llama3.2")
+
+    print(f"   Using LLM Provider: {ai.provider_name} (Model: {ai.model})")
+
+    # 2. Instantiate the OpenClawManager
+    # This downloader and process runner resides in NeuralNode.
+    print("\n2. Initializing OpenClawManager...")
+    manager = OpenClawManager(
+        node=ai,
+        install_dir="./openclaw_runtime",  # Download path for OpenClaw repo
+        gateway_port=18789,                # OpenClaw client gateway port
+        api_server_port=18788,             # OpenAI-compatible API server port
+        api_key="neuralnode-secret-key"    # Gateway authorization key
+    )
+    print(f"   Runtime Directory: {manager.install_dir}")
+
+    # 3. Setup OpenClaw (Clone git repository & npm install dependencies)
+    # Note: Ensure git and node/npm (or pnpm) are installed on your machine.
+    print("\n3. Setting up OpenClaw gateway...")
+    print("   (Cloning repo and installing Node dependencies; this can take a minute)...")
+    try:
+        # Check if already installed
+        if not (manager.install_dir / "openclaw").exists():
+            manager.setup()
+            print("   ✅ OpenClaw successfully cloned and dependencies installed!")
+        else:
+            print("   ✅ OpenClaw runtime already exists.")
+            # Ensure configurations are up to date
+            manager.configure()
+    except Exception as e:
+        print(f"   ❌ Setup failed: {e}")
+        print("   Make sure Node.js, npm/pnpm, and git are installed and on your PATH.")
+        return
+
+    # 4. Start OpenClaw Gateway (Runs uvicorn API and OpenClaw Node gateway process)
+    print("\n4. Starting OpenClaw Gateway...")
+    try:
+        manager.start()
+        print("   ✅ OpenClaw API server and Node gateway started successfully!")
+    except Exception as e:
+        print(f"   ❌ Failed to start: {e}")
+        return
+
+    # 5. Use OpenClawClient to control the running agent gateway
+    print("\n5. Controlling OpenClaw Gateway...")
+    client = manager.get_client()
+    
+    # Check gateway status
+    if client.check_health():
+        print("   ✅ OpenClaw Gateway is online and healthy.")
+        
+        # Create a new session
+        session_id = "test-session-1"
+        print(f"   Creating session '{session_id}'...")
+        client.create_session(session_id)
+        
+        # Send a prompt/task to the agent
+        task = "Introduce yourself in one sentence."
+        print(f"   Sending task: '{task}'...")
+        response = client.send_task(session_id, task)
+        print(f"   Response: {response}")
+        
+        # Get status/logs of execution
+        status = client.get_session_status(session_id)
+        print(f"   Session Status: {status.get('status', 'N/A')}")
+    else:
+        print("   ❌ OpenClaw Gateway did not respond to health check.")
+
+    # 6. Shutting down the gateway processes safely
+    print("\n6. Stopping OpenClaw Gateway...")
+    manager.stop()
+    print("   ✅ OpenClaw stopped successfully.")
+    print("=" * 60)
+    print("🎉 Demo finished!")
+
+if __name__ == "__main__":
+    main()

neuralnode-2.2.0/examples/whatsapp_bot_demo.py

@@ -0,0 +1,141 @@
+"""
+NeuralNode WhatsApp AI Chatbot & Agent Demo
+==========================================
+
+This script demonstrates how to start the WhatsApp Gateway (Evolution API),
+link a WhatsApp account (via QR code or Pairing code), setup a local webhook
+listener, and run an automated AI Agent chatbot on WhatsApp.
+"""
+
+import time
+import os
+import sys
+from pathlib import Path
+import neuralnode as nn
+from neuralnode.integrations.whatsapp import EvolutionWhatsAppBot
+
+def main():
+    print("🚀 NeuralNode WhatsApp AI Chatbot Demo")
+    print("=" * 60)
+
+    # 1. Initialize the NeuralNode Agent
+    print("\n1. Initializing AI Agent...")
+    try:
+        # Using auto-select provider or local Ollama
+        ai = nn.NeuralNode(provider="auto")
+    except Exception:
+        print("   ⚠️ No provider API keys found. Falling back to ollama.")
+        ai = nn.NeuralNode(provider="ollama", model="llama3.2")
+        
+    # Give the agent some tools/skills
+    agent = ai.agent(skills=["web_search", "datetime"], system_prompt="You are a helpful WhatsApp AI Assistant.")
+    print(f"   Agent initialized with capabilities: {ai.provider_name} (Model: {ai.model})")
+
+    # 2. Initialize the Evolution WhatsApp Bot
+    print("\n2. Initializing Evolution WhatsApp Bot...")
+    bot = EvolutionWhatsAppBot(
+        api_url="http://localhost:8080",
+        global_apikey="my-secret-key",
+        agent=agent
+    )
+
+    # 3. Start the local WhatsApp Gateway
+    # Note: This will run `npm install` and start the gateway process in background.
+    print("\n3. Starting WhatsApp Gateway...")
+    print("   (This runs the Node.js Baileys gateway under the hood. Wait ~15s)...")
+    try:
+        bot.start_gateway(port=8080, wait_seconds=15)
+        print("   ✅ WhatsApp Gateway is running.")
+    except Exception as e:
+        print(f"   ❌ Failed to start WhatsApp Gateway: {e}")
+        print("   Please check that Node.js (v18+) is installed and on your PATH.")
+        return
+
+    instance_name = "neuralnode-bot"
+
+    # 4. Linking your WhatsApp Account
+    # You can connect via QR Code (scanning it on your phone) OR Pairing Code (entering it on your phone).
+    print("\n4. Linking Account to WhatsApp...")
+    print("   Choose your connection method:")
+    print("   [1] QR Code (recommended - generates a PNG to scan)")
+    print("   [2] Pairing Code (enter your phone number to get an 8-character code)")
+    
+    choice = input("Select connection method (1/2) [Default: 1]: ").strip() or "1"
+    
+    if choice == "2":
+        phone_number = input("Enter your WhatsApp phone number with country code (e.g. +20123456789): ").strip()
+        if not phone_number:
+            print("   ❌ Phone number is required for pairing code. Exiting.")
+            bot.stop_gateway()
+            return
+        
+        print(f"   Requesting pairing code for {phone_number}...")
+        try:
+            pairing_code = bot.connect_phone(instance_name, phone_number)
+            print("\n" + "*" * 50)
+            print(f"👉 PAIRING CODE: {pairing_code}")
+            print("To link your phone:")
+            print("1. Open WhatsApp -> Linked Devices -> Link with Phone Number.")
+            print(f"2. Enter the Pairing Code above: {pairing_code}")
+            print("*" * 50 + "\n")
+        except Exception as e:
+            print(f"   ❌ Failed to get pairing code: {e}")
+            bot.stop_gateway()
+            return
+    else:
+        print("   Generating QR code...")
+        try:
+            qr_path = bot.connect_qr(instance_name)
+            print("\n" + "*" * 50)
+            print(f"👉 QR CODE SAVED TO: {qr_path}")
+            print("To link your phone:")
+            print("1. Open WhatsApp -> Linked Devices -> Link a Device.")
+            print(f"2. Scan the QR code image saved at the path above.")
+            print("*" * 50 + "\n")
+        except Exception as e:
+            print(f"   ❌ Failed to generate QR code: {e}")
+            bot.stop_gateway()
+            return
+
+    # 5. Start the Webhook Listener & configure gateway webhook
+    # Baileys gateway will POST incoming messages to this webhook,
+    # which will then run the agent and automatically reply back.
+    print("\n5. Starting Webhook Listener and Router...")
+    webhook_port = 5000
+    try:
+        # Start a local HTTP server on port 5000
+        bot.start_webhook_listener(port=webhook_port)
+        
+        # Configure the gateway to send updates to our listener
+        # In a real environment, you'd use a public URL (e.g., ngrok or production domain)
+        # For local development with docker/local processes, use localhost
+        webhook_url = f"http://localhost:{webhook_port}"
+        bot.set_webhook(instance_name, webhook_url)
+        print(f"   ✅ Webhook listener online at {webhook_url}")
+    except Exception as e:
+        print(f"   ❌ Failed to initialize webhook: {e}")
+        bot.stop_gateway()
+        return
+
+    # 6. Wait and handle chat chatbot conversations
+    print("\n6. Bot is running! Waiting for messages...")
+    print("   Send a message to your connected WhatsApp number from another phone.")
+    print("   The chatbot agent will process it and respond automatically.")
+    print("   Press Ctrl+C to terminate.")
+    
+    try:
+        # Keep the script running to listen to webhook events
+        while True:
+            state = bot.connection_state(instance_name)
+            print(f"   [Status Check] Current connection state: '{state}'", end="\r", flush=True)
+            time.sleep(5)
+    except KeyboardInterrupt:
+        print("\n\n👋 Stopping WhatsApp Bot and Gateway...")
+    finally:
+        # Cleanup
+        bot.stop_webhook_listener()
+        bot.stop_gateway()
+        print("✅ Shutdown complete.")
+
+if __name__ == "__main__":
+    main()

{neuralnode-2.1.13 → neuralnode-2.2.0}/publish.bat

@@ -47,7 +47,15 @@ twine check dist/*
 
 REM Upload to PyPI
 echo 📤 Uploading to PyPI...
-twine upload dist/* --username __token__ --password pypi-AgEIcHlwaS5vcmcCJGNhOWI0OTJlLWRkNTAtNGU1OC04MDBkLTVjZDVjNzg2MDc0ZAACKlszLCJiMzI5ODAyMi04MjlhLTRlODItOWQzMC1iNzlmZWM2NjdlZmIiXQAABiB05_WnyXXN1F0zHr2jnG3HZt5Nir65IqELsuEDa71XZQ
+if "%TWINE_USERNAME%"=="" (
+    echo Error: set TWINE_USERNAME and TWINE_PASSWORD before publishing.
+    exit /b 1
+)
+if "%TWINE_PASSWORD%"=="" (
+    echo Error: set TWINE_USERNAME and TWINE_PASSWORD before publishing.
+    exit /b 1
+)
+twine upload dist/*
 
 REM Verify upload
 echo ✅ Verifying upload...

{neuralnode-2.1.13 → neuralnode-2.2.0}/publish.sh

@@ -46,9 +46,11 @@ twine check dist/*
 
 # Upload to PyPI
 echo "📤 Uploading to PyPI..."
-twine upload dist/* \
-    --username __token__ \
-    --password pypi-AgEIcHlwaS5vcmcCJGNhOWI0OTJlLWRkNTAtNGU1OC04MDBkLTVjZDVjNzg2MDc0ZAACKlszLCJiMzI5ODAyMi04MjlhLTRlODItOWQzMC1iNzlmZWM2NjdlZmIiXQAABiB05_WnyXXN1F0zHr2jnG3HZt5Nir65IqELsuEDa71XZQ
+if [ -z "$TWINE_USERNAME" ] || [ -z "$TWINE_PASSWORD" ]; then
+    echo "Error: set TWINE_USERNAME and TWINE_PASSWORD before publishing."
+    exit 1
+fi
+twine upload dist/*
 
 # Verify upload
 echo "✅ Verifying upload..."

{neuralnode-2.1.13 → neuralnode-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "neuralnode"
-version = "2.1.13"
+version = "2.2.0"
 description = "Comprehensive AI Framework with 50+ LLM Providers, Advanced Agents, Chains, Memory, RAG, and 100+ Tools"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -155,6 +155,11 @@ telegram = [
 ]
 discord = ["discord.py>=2.3.0"]
 slack = ["slack-sdk>=3.21.0"]
+whatsapp = ["twilio>=9.0.0"]
+openclaw = [
+    "fastapi>=0.110.0",
+    "uvicorn>=0.27.0",
+]
 
 # All features
 all = [
@@ -179,6 +184,9 @@ all = [
     "einops>=0.7.0",
     "sentence-transformers>=2.2.0",
     "python-telegram-bot>=20.0",
+    "twilio>=9.0.0",
+    "fastapi>=0.110.0",
+    "uvicorn>=0.27.0",
     "edge-tts>=6.1.0",
     "SpeechRecognition>=3.10.0",
     "pydub>=0.25.1",

{neuralnode-2.1.13 → neuralnode-2.2.0}/scripts/setup.py

@@ -105,7 +105,7 @@ def setup_neuralnode():
     print("✅ Setup complete! You can now use NeuralNode.")
     print("\nQuick start:")
     print("  import neuralnode as nn")
-    print("  ai = nn.NeuralNode(provider='openai')")
+    print("  ai = nn.NeuralNode(provider='groq', model='llama-3.1-8b-instant')")
     print("  print(ai.chat('Hello!'))")
     print("\nRun tests:")
     print("  pytest tests/ -v")

{neuralnode-2.1.13 → neuralnode-2.2.0}/src/neuralnode/__init__.py

@@ -42,7 +42,7 @@ Quick Start::
     text = sr.listen()
 """
 
-__version__ = "2.1.12"
+__version__ = "2.2.0"
 __author__ = "NeuralNode Contributors"
 
 # ── Core types ────────────────────────────────────────────────────────────────
@@ -190,9 +190,6 @@ try:
 except ImportError:
     _THINKING_AVAILABLE = False
 
-# OpenAI blocker
-from .core.openai_blocker import check_openai_blocked
-
 # Chains module
 try:
     from .chains import (
@@ -229,6 +226,26 @@ try:
 except ImportError:
     _SLACK_AVAILABLE = False
 
+try:
+    from .integrations.whatsapp import (
+        EvolutionWhatsAppBot,
+        TwilioWhatsAppBot,
+        create_twilio_whatsapp_bot,
+    )
+    _WHATSAPP_AVAILABLE = True
+except ImportError:
+    _WHATSAPP_AVAILABLE = False
+
+try:
+    from .integrations.openclaw import (
+        OpenClawManager,
+        OpenClawServer,
+        OpenClawClient,
+    )
+    _OPENCLAW_AVAILABLE = True
+except ImportError:
+    _OPENCLAW_AVAILABLE = False
+
 # Logging helper
 from .utils.logger import get_logger, setup_logging
 from .utils.dependencies import ensure_feature_dependencies
@@ -289,7 +306,8 @@ class NeuralNode:
 
     Example::
 
-        # OpenAI is blocked — use any of these instead:
+        # OpenAI is fully supported — use any of these:
+        ai = NeuralNode(provider="openai")                # OpenAI GPT-4o/mini
         ai = NeuralNode(provider="anthropic")             # Claude
         ai = NeuralNode(provider="google")                # Gemini
         ai = NeuralNode(provider="groq")                  # Groq
@@ -307,13 +325,6 @@ class NeuralNode:
         model_settings: dict = None,
         **kwargs,
     ):
-        # Block OpenAI before doing anything else
-        check_openai_blocked(
-            provider=provider,
-            model=model,
-            api_key=api_key,
-        )
-
         self.provider_name = provider.lower()
         self.model = model
         self.system_prompt = system_prompt or "You are a helpful AI assistant."
@@ -684,10 +695,8 @@ __all__ = [
     "RouterChain", "RetrievalQAChain", "TransformChain", "APIChain",
     "create_llm_chain", "create_sequential_chain", "create_retrieval_qa_chain",
 
-    # Utilities
     "get_logger", "setup_logging",
     "ensure_feature_dependencies",
-    "check_openai_blocked",
 ]
 
 # Add optional exports
@@ -721,3 +730,15 @@ if _TURBOQUANT_AVAILABLE:
     __all__ += ["TurboQuant", "TurboQuantEngine", "TurboQuantConfig"]
 if _THINKING_AVAILABLE:
     __all__ += ["ThinkingMode", "ThinkingResponse", "enable_thinking"]
+if _WHATSAPP_AVAILABLE:
+    __all__ += [
+        "EvolutionWhatsAppBot",
+        "TwilioWhatsAppBot",
+        "create_twilio_whatsapp_bot",
+    ]
+if _OPENCLAW_AVAILABLE:
+    __all__ += [
+        "OpenClawManager",
+        "OpenClawServer",
+        "OpenClawClient",
+    ]

neuralnode-2.2.0/src/neuralnode/core/openai_blocker.py

@@ -0,0 +1,29 @@
+"""Compatibility shim for historical OpenAI blocking hooks.
+
+The current NeuralNode feature set includes OpenAI-compatible providers, so the
+old blocker API remains as a no-op to avoid breaking imports.
+"""
+
+from __future__ import annotations
+
+from typing import Optional
+
+
+def is_openai_key(api_key: Optional[str]) -> bool:
+    return False
+
+
+def is_openai_model(model: Optional[str]) -> bool:
+    return False
+
+
+def check_openai_blocked(
+    provider: Optional[str] = None,
+    model: Optional[str] = None,
+    api_key: Optional[str] = None,
+    base_url: Optional[str] = None,
+) -> None:
+    return None
+
+
+__all__ = ["check_openai_blocked", "is_openai_key", "is_openai_model"]

neuralnode-2.2.0/src/neuralnode/integrations/__init__.py

@@ -0,0 +1,23 @@
+"""NeuralNode Messaging and Agent Gateways integrations."""
+
+from .telegram import TelegramBot, TelegramAgent, TelegramBotConfig, TelegramBotBuilder, create_telegram_bot
+from .discord import DiscordBot
+from .slack import SlackBot
+from .whatsapp import EvolutionWhatsAppBot, TwilioWhatsAppBot, create_twilio_whatsapp_bot
+from .openclaw import OpenClawManager, OpenClawServer, OpenClawClient
+
+__all__ = [
+    "TelegramBot",
+    "TelegramAgent",
+    "TelegramBotConfig",
+    "TelegramBotBuilder",
+    "create_telegram_bot",
+    "DiscordBot",
+    "SlackBot",
+    "EvolutionWhatsAppBot",
+    "TwilioWhatsAppBot",
+    "create_twilio_whatsapp_bot",
+    "OpenClawManager",
+    "OpenClawServer",
+    "OpenClawClient",
+]