neuralnode 2.2.8__tar.gz → 2.2.10__tar.gz

{neuralnode-2.2.8 → neuralnode-2.2.10}/.env.example

@@ -1,35 +1,22 @@
-# NeuralNode Environment Configuration
-# Copy this file to .env and fill in your API keys
-
-# OpenAI Configuration
-OPENAI_API_KEY=sk-your-openai-api-key-here
-OPENAI_BASE_URL=https://api.openai.com/v1
-
-# Anthropic Configuration
-ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here
-
-# Google (Gemini) Configuration
-GOOGLE_API_KEY=your-google-api-key-here
-
-# Ollama Configuration (for local models)
-# No API key needed, just ensure Ollama is running
-OLLAMA_BASE_URL=http://localhost:11434
-
-# Horus Cyber Nano 1.0 BETA Early Access
-HORUS_CYBER_NANO_API_KEY=horusNN-your-access-token
-HORUS_CYBER_NANO_BASE_URL=https://api.tokenai.llc/v1
-
-# NeuralNode H-Preview API Gateway
-NEURALNODE_API_DB=neuralnode-api.sqlite3
-NEURALNODE_API_KEY=nn-your-24-character-token
-NEURALNODE_API_BASE_URL=http://127.0.0.1:8000/v1
-H_PREVIEW_UPSTREAM_URL=http://127.0.0.1:8001/v1
-H_PREVIEW_UPSTREAM_MODEL=DavidAU/Qwen3.8-27B-TURBO-Fable-Cold-Fusion-735-882-Heretic-Uncensored-NM-DAU
-# Optional: only set this when the remote model server requires an API key.
-# H_PREVIEW_UPSTREAM_API_KEY=
-
-# NeuralNode Settings
-NEURALNODE_DEFAULT_PROVIDER=auto
-NEURALNODE_MEMORY_ENABLED=true
-NEURALNODE_SAFE_MODE=true
-NEURALNODE_LOG_LEVEL=INFO
+# NeuralNode Environment Configuration
+# Copy this file to .env and fill in your API keys
+
+# OpenAI Configuration
+OPENAI_API_KEY=sk-your-openai-api-key-here
+OPENAI_BASE_URL=https://api.openai.com/v1
+
+# Anthropic Configuration
+ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here
+
+# Google (Gemini) Configuration
+GOOGLE_API_KEY=your-google-api-key-here
+
+# Ollama Configuration (for local models)
+# No API key needed, just ensure Ollama is running
+OLLAMA_BASE_URL=http://localhost:11434
+
+# NeuralNode Settings
+NEURALNODE_DEFAULT_PROVIDER=auto
+NEURALNODE_MEMORY_ENABLED=true
+NEURALNODE_SAFE_MODE=true
+NEURALNODE_LOG_LEVEL=INFO

{neuralnode-2.2.8 → neuralnode-2.2.10}/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,15 +1,15 @@
-## Summary
-
-Describe the problem and the change made.
-
-## Validation
-
-- [ ] I ran the relevant tests and checks.
-- [ ] I added or updated tests where appropriate.
-- [ ] I did not include secrets, credentials, or private data.
-- [ ] I have read and agree to [TOKENAI_CLA.md](../TOKENAI_CLA.md).
-- [ ] I have identified any third-party code, data, or assets included in this PR.
-
-## Notes for review
-
-Add compatibility notes, migration details, or known limitations here.
+## Summary
+
+Describe the problem and the change made.
+
+## Validation
+
+- [ ] I ran the relevant tests and checks.
+- [ ] I added or updated tests where appropriate.
+- [ ] I did not include secrets, credentials, or private data.
+- [ ] I have read and agree to [TOKENAI_CLA.md](../TOKENAI_CLA.md).
+- [ ] I have identified any third-party code, data, or assets included in this PR.
+
+## Notes for review
+
+Add compatibility notes, migration details, or known limitations here.

{neuralnode-2.2.8 → neuralnode-2.2.10}/.github/workflows/tests.yml

@@ -1,86 +1,86 @@
-name: Tests
-
-on:
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/checkout@v7
-
-    - name: Set up Python
-      uses: actions/setup-python@v7
-      with:
-        python-version: "3.12"
-
-    - name: Install build tools
-      run: python -m pip install --upgrade build twine
-
-    - name: Build source distribution and wheel
-      run: python -m build --outdir .ci-dist
-
-    - name: Validate package metadata
-      run: python -m twine check .ci-dist/*
-
-    - name: Install wheel and verify package version
-      run: |
-        python -m pip install --force-reinstall .ci-dist/*.whl
-        python -c "import neuralnode; assert neuralnode.__version__ == '2.2.8'; print(neuralnode.__version__)"
-
-  test:
-    # Python 3.9 is no longer available on the newest Ubuntu runner image.
-    runs-on: ubuntu-24.04
-    strategy:
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
-
-    steps:
-    - uses: actions/checkout@v7
-
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v7
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install -e ".[dev]"
-
-    - name: Run tests
-      run: |
-        pytest tests/ -v --cov=src/neuralnode --cov-report=xml --cov-report=term
-
-    - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v7
-      with:
-        files: ./coverage.xml
-        flags: unittests
-        name: codecov-umbrella
-
-  lint:
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/checkout@v7
-
-    - name: Set up Python
-      uses: actions/setup-python@v7
-      with:
-        python-version: "3.11"
-
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install black ruff mypy
-
-    - name: Check formatting with black
-      run: black --check src/neuralnode
-
-    # The legacy tree has broad style/type debt; keep CI focused on undefined
-    # names while that debt is addressed incrementally.
-    - name: Check undefined names with ruff
-      run: ruff check src/neuralnode --select F821
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.12"
+
+    - name: Install build tools
+      run: python -m pip install --upgrade build twine
+
+    - name: Build source distribution and wheel
+      run: python -m build --outdir .ci-dist
+
+    - name: Validate package metadata
+      run: python -m twine check .ci-dist/*
+
+    - name: Install wheel and verify package version
+      run: |
+        python -m pip install --force-reinstall .ci-dist/*.whl
+        python -c "import neuralnode; assert neuralnode.__version__ == '2.2.10'; print(neuralnode.__version__)"
+
+  test:
+    # Python 3.9 is no longer available on the newest Ubuntu runner image.
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v7
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Run tests
+      run: |
+        pytest tests/ -v --cov=src/neuralnode --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v7
+      with:
+        files: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+
+  lint:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@v7
+
+    - name: Set up Python
+      uses: actions/setup-python@v7
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install black ruff mypy
+
+    - name: Check formatting with black
+      run: black --check src/neuralnode
+
+    # The legacy tree has broad style/type debt; keep CI focused on undefined
+    # names while that debt is addressed incrementally.
+    - name: Check undefined names with ruff
+      run: ruff check src/neuralnode --select F821

{neuralnode-2.2.8 → neuralnode-2.2.10}/.gitignore

@@ -1,38 +1,41 @@
-# Python
-__pycache__/
-*.pyc
-*.pyo
-*.pyd
-*.egg-info/
-dist/
-release-dist/
-build/
-.eggs/
-
-# Virtual envs
-.venv/
-venv/
-env/
-
-# Local credentials and environment files
-.env
-.env.*
-!.env.example
-**/.env
-**/.env.*
-!**/.env.example
-
-# Temp / outputs
-temp_header.gguf
-outputs/
-.tmp_*
-*.gguf.tmp
-
-# Test caches
-.pytest_cache/
-.mypy_cache/
-.ruff_cache/
-
-# OS
-.DS_Store
-Thumbs.db
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+release-dist/
+.release-dist*/
+.ci-dist/
+.ci-dist-verify*/
+.install-check*/
+build/
+.eggs/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# Local credentials and environment files
+.env
+.env.*
+!.env.example
+**/.env
+**/.env.*
+!**/.env.example
+
+# Temp / outputs
+outputs/
+.tmp_*
+*.gguf.tmp
+
+# Test caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db

neuralnode-2.2.10/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+All notable changes to NeuralNode are documented here.
+
+## 2.2.10 — 2026-11-01
+
+### Documentation and branding
+
+- Added the dark NeuralNode wordmark as a transparent PNG for reliable display
+  on light PyPI pages and other light backgrounds.
+- Updated the README image reference to the published transparent asset.
+
+## 2.2.9 — 2026-11-01
+
+### Integrations and runtime cleanup
+
+- Removed the deprecated WhatsApp/Twilio integration and legacy API gateway.
+- Removed obsolete provider and deployment artifacts from the maintained core.
+- Updated the OpenClaw manager for the current OpenClaw configuration schema,
+  loopback-only gateway binding, token authentication, and OpenAI-compatible
+  chat-completions enablement.
+- Added a blocking-chat fallback for OpenClaw streaming requests so providers
+  without native streaming can still complete gateway turns.
+- Validated the NeuralNode → OpenClaw → local Qwen/llama.cpp path on AWS.
+- Upgraded Ollama chat integration to the native `/api/chat` protocol with
+  role-preserving messages, streaming, structured output, and tool calls.
+- Added Ollama native reasoning control through `thinking=True` or
+  `thinking=False`, preserving the model trace in response metadata.
+- Updated Ollama embeddings to the batch `/api/embed` endpoint with a legacy
+  compatibility fallback.
+- Removed the remaining Twilio optional dependency with the retired WhatsApp
+  integration.
+
+## 2.2.8 — 2026-11-01
+
+NeuralNode 2.2.8 is a feature and reliability release focused on local model
+execution, multimodal workflows, integrations, and reproducible packaging.
+
+### Multimodal and local model support
+
+- Added local Hugging Face speech adapters:
+  - `HuggingFaceSTT` for audio transcription.
+  - `HuggingFaceTTS` for text-to-speech generation.
+- Added configurable Hugging Face model IDs, lazy loading, language handling,
+  CPU/CUDA device selection, and WAV output for the speech adapters.
+- Added local vision-language input support through the existing image chat
+  interface.
+- Added Diffusers-compatible local text-to-image loading and generation.
+- Improved local model generation determinism and provider identity.
+- Improved model repository download handling for Hugging Face sources.
+- Added explicit authentication support for private and gated Hugging Face
+  repositories using `HF_TOKEN` or an explicit token parameter.
+- Made optional Horus runtime imports tolerant of environments where the heavy
+  local ML dependencies are not installed.
+
+### Voice workflows
+
+- Added a sequential `VoiceAgent` pipeline for file-based and push-to-talk
+  interactions:
+
+  `audio input → speech-to-text → agent/LLM turn → text-to-speech → audio output`
+
+- Added HTTP speech adapters for connecting external STT and TTS services.
+- Documented the distinction between sequential voice turns and low-latency,
+  full-duplex live audio. Full-duplex streaming is outside this release.
+
+### Agents and tools
+
+- Improved provider-backed agent tool calling.
+- Added support for textual actions from tool-capable models.
+- Improved tool-result message handling and buffered streaming compatibility.
+- Preserved the existing agents, memory, RAG, embeddings, vector-store, and
+  integration APIs.
+
+### Horus and OpenClaw
+
+- Aligned Horus and OpenClaw integrations with the current public interfaces.
+- Secured the OpenClaw local API behavior.
+- Added test paths that do not require optional OpenClaw HTTP test packages.
+### Release engineering
+
+- Added source distribution and wheel build validation in CI.
+- Isolated package build output from repository working files.
+- Added trusted PyPI publishing through GitHub Actions and PyPI's OIDC
+  trusted-publishing flow.
+- Added public repository, ownership, license, and release metadata alignment.
+
+### Compatibility and limitations
+
+- Python 3.9, 3.10, 3.11, and 3.12 are supported by the package metadata.
+- Heavy local-model, image, and speech features remain optional extras; the
+  base installation does not install those large runtime dependencies.
+- Public Hugging Face models can be loaded without a token. Private or gated
+  repositories require a valid `HF_TOKEN`.
+- The voice pipeline in this release processes one turn at a time. It is not a
+  real-time, full-duplex audio session.
+

{neuralnode-2.2.8 → neuralnode-2.2.10}/CONTRIBUTING.md

@@ -1,40 +1,40 @@
-# Contributing to NeuralNode
-
-Thank you for helping improve NeuralNode. Contributions may be submitted by
-opening an issue, creating a fork, or opening a pull request.
-
-## Pull request workflow
-
-1. Create a focused branch or fork.
-2. Explain the problem and the proposed change.
-3. Include or update tests when appropriate.
-4. Run the relevant checks locally.
-5. Open a pull request against the default branch.
-
-All pull requests are subject to review by TokenAI. Opening a pull request
-does not guarantee acceptance or merge. TokenAI may accept, request changes,
-reject, close, or remove a proposed contribution at its sole discretion.
-
-## Contribution terms
-
-By submitting a pull request, patch, issue attachment, or other contribution to
-this repository, you confirm that you have read and agree to the
-[TokenAI Contributor License Agreement](TOKENAI_CLA.md), and that:
-
-- you have the legal right to submit the contribution;
-- the contribution is your original work or you have permission to submit it;
-- you have identified any third-party code, data, or assets included in it;
-- you have not knowingly included secrets, credentials, or private data; and
-- you agree to the copyright assignment and license grant in
-  [TOKENAI_CLA.md](TOKENAI_CLA.md).
-
-## Attribution
-
-Contributions become part of a project owned and maintained by TokenAI. Do not
-remove existing NeuralNode or TokenAI notices. Derivative products and forks
-must continue to follow [LICENSE](LICENSE) and [TRADEMARKS.md](TRADEMARKS.md).
-
-## Code of conduct
-
-Be respectful, constructive, and specific. Harassment, discrimination,
-deliberate disclosure of secrets, and malicious code are not acceptable.
+# Contributing to NeuralNode
+
+Thank you for helping improve NeuralNode. Contributions may be submitted by
+opening an issue, creating a fork, or opening a pull request.
+
+## Pull request workflow
+
+1. Create a focused branch or fork.
+2. Explain the problem and the proposed change.
+3. Include or update tests when appropriate.
+4. Run the relevant checks locally.
+5. Open a pull request against the default branch.
+
+All pull requests are subject to review by TokenAI. Opening a pull request
+does not guarantee acceptance or merge. TokenAI may accept, request changes,
+reject, close, or remove a proposed contribution at its sole discretion.
+
+## Contribution terms
+
+By submitting a pull request, patch, issue attachment, or other contribution to
+this repository, you confirm that you have read and agree to the
+[TokenAI Contributor License Agreement](TOKENAI_CLA.md), and that:
+
+- you have the legal right to submit the contribution;
+- the contribution is your original work or you have permission to submit it;
+- you have identified any third-party code, data, or assets included in it;
+- you have not knowingly included secrets, credentials, or private data; and
+- you agree to the copyright assignment and license grant in
+  [TOKENAI_CLA.md](TOKENAI_CLA.md).
+
+## Attribution
+
+Contributions become part of a project owned and maintained by TokenAI. Do not
+remove existing NeuralNode or TokenAI notices. Derivative products and forks
+must continue to follow [LICENSE](LICENSE) and [TRADEMARKS.md](TRADEMARKS.md).
+
+## Code of conduct
+
+Be respectful, constructive, and specific. Harassment, discrimination,
+deliberate disclosure of secrets, and malicious code are not acceptable.